Minimal MCP Sunucusu Nasıl Yazılır

Bu rehber ne yapar

Minimal MCP Sunucusu akışında önce kaynak sınırı, sonra araç izni, en son model cevabı kontrol edilir. Böyle yapmazsanız RAG hatasını model kalitesi sanmanız çok kolaydır. Bu iş sonunda Llama 3.3 70B için tarihli bir karar kanıtı oluşur, RTX 3060 12GB sınıfı donanım not edilir ve ölçüm Türkçe halüsinasyon direnci ile ilişkilendirilir. Akış Python ile yürür; daha geniş bağlam Kurs G002: Ajan ve Araç Çağrısı içinde işlenir.

Yasal uyarı: Bu içerik eğitim amaçlı teknik çalışma notudur; hukuki görüş, mevzuat yorumu, uyum belgesi veya profesyonel danışmanlık değildir. Kişisel veri, sağlık, finans, çocuk/öğrenci verisi, telif veya regüle sektörlerde gerçek uygulamadan önce yetkin hukuk/uyum uzmanıyla yazılı değerlendirme alın.
Operatör notu: Minimal MCP Sunucusu Nasıl Yazılır: RAG veya ajan akışı kaynak, izin ve log sınırı olmadan demo sayılır; üretim kanıtı sayılmaz. İleri seviyede her varsayımı tarihli yazın; sürüm, sürücü veya lisans değişince karar tekrar açılabilsin. Bu rehberde beklenen kanıt outputs/mcp-minimal-sunucu.json dosyasıdır.

Ön koşullar

  • Ubuntu 24.04 LTS ya da eşdeğer geliştirme ortamı.
  • Yerel çalışma zamanı kontrolü: python -V.
  • Minimal MCP Sunucusu: Sentetik veya izinli küçük bir belge örneği; gerçek müşteri, hasta, öğrenci ya da dava verisiyle deneme yapmayın.
  • Terminal çıktısı UTF-8 olmalı; Windows tarafında şüphede kalırsanız chcp çıktısını kaydedin.

Adımlar

  1. Kanıt klasörünü aç. Minimal MCP Sunucusu için çıktıyı mcp minimal sunucu adıyla ayır; aynı klasöre log ve kısa rapor da girecek.
mkdir -p outputs logs reports
  1. Küçük kanıtı üret. Minimal MCP Sunucusu için Ajan ve RAG denemelerinde kaynak dosyası, izin listesi ve model cevabı ayrı iz bırakmalıdır. Bu komut gerçek veriyi çağırmadan Llama 3.3 70B etiketini karar dosyasına işler.
mkdir -p outputs
python - <<'PY'
from pathlib import Path
Path("outputs/mcp-minimal-sunucu.json").write_text('{"model":"llama-3-3-70b","status":"kontrol-tamam"}\n', encoding="utf-8")
print("outputs/mcp-minimal-sunucu.json yazıldı")
PY
  1. Özeti kilitle. Minimal MCP Sunucusu özetini daha sonra değişiklik yakalamak için kullanacaksınız; Türkçe halüsinasyon direnci notunu bu hash ile birlikte saklayın.
python - <<'PY'
from hashlib import sha256
from pathlib import Path
p = Path("outputs/mcp-minimal-sunucu.json")
print(sha256(p.read_bytes()).hexdigest(), p)
PY
  1. Türkçe kırılmayı ara. Minimal MCP Sunucusu Nasıl Yazılır cevabı ortasında İngilizceye kayarsa sistem istemine tek dil kısıtı ekleyin ve aynı girdiyi tekrar çalıştırın. Çıktı temizse Python tarafındaki sıradaki adıma geçebilirsiniz.

Doğrulama

Tek komutla son durumu doğrula:

python - <<'PY'
import json
from pathlib import Path
p = Path("outputs/mcp-minimal-sunucu.json")
data = json.loads(p.read_text(encoding="utf-8"))
print(p.exists(), data["status"])
print("kanıt:", p)
print("model:", data["model"])
PY

Beklenen çıktı:

True kontrol-tamam
kanıt: outputs/mcp-minimal-sunucu.json
model: llama-3-3-70b

Yaygın Hatalar

  • `ModuleNotFoundError` — Python ortamı rehber için beklenen paketi görmüyor. Çözüm: python -V çıktısını kaydedin, sanal ortamı etkinleştirin ve komutu aynı kabukta tekrar çalıştırın.
  • `kaynak bulunamadı` — RAG/ajan denemesi kaynak belgesini ya da araç izinini görmüyor. Çözüm: belge yolunu mutlak yazın, izin listesini daraltın ve sentetik örnekle yeniden koşun.
  • `Türkçe karakterler bozuk` — Minimal MCP Sunucusu Nasıl Yazılır çıktısında Türkçe harfler okunmuyorsa kodlama katmanı karışmıştır. Çözüm: locale çıktısını kontrol edin ve dosyayı UTF-8 olarak tekrar üretin.
  • `outputs/mcp-minimal-sunucu.json yok` — Rehberin sonunda beklenen kanıt dosyası oluşmamış. Çözüm: önce çalışma klasörünü oluşturun, sonra karar kanıtı adımını tek başına tekrar çalıştırın.
Veri koruma uyarısı: Bu rehber KVKK uyum kararı vermez. Kişisel veri içeren örnekleri üretimde kullanmadan önce amaç, saklama süresi, erişim yetkisi ve yurtdışı aktarım ihtimalini yetkin hukuk/uyum uzmanıyla doğrulayın. Başlangıç noktası: KVKK ve AI.

İlgili rehberler

İlgili katalog girişleri