MCP Kaynak Hizmeti

Bu hizmet, Doç. Dr. Ediz Yeşilkaya web sitesinin herkese açık rehberlerini MCP istemcilerine sunar. Veritabanına veya hasta kayıtlarına bağlanmaz. Soru-cevap ya da tıbbi değerlendirme hizmeti değildir.

Bağlantı ve erişim

Streamable HTTP adresi: https://www.edizyesilkaya.com.tr/mcp/. Bağlanırken sondaki eğik çizgiyi koruyun. Hizmet herkese açıktır; erişim anahtarı ve kullanıcı oturumu istemez. Oturum kimliği oluşturmayan, JSON yanıtlı bir uygulamadır. Sağlık belgesi veya kişisel hasta bilgisi göndermeyin.

Desteklenen MCP protokol sürümleri: 2025-11-25, 2025-06-18, 2025-03-26. Normal kullanımda güncel sürümle initialize isteği gönderin; sunucunun yanıtındaki sürümü izleyin.

İstek akışı

1. POST /mcp/ üzerinden initialize isteği gönderin.
2. Yanıttaki protokol ve yetenekleri kontrol edip notifications/initialized bildirimini gönderin. Bildirim yanıtı boş gövdeli HTTP 202'dir.
3. Sonraki isteklerde MCP-Protocol-Version başlığını anlaşılmış sürüme ayarlayın. Her istek ayrı bir JSON-RPC 2.0 POST mesajıdır.

İstek başlıkları: Content-Type: application/json ve Accept: application/json, text/event-stream. Sunucu JSON yanıt döndürür; ayrı bir SSE akışı sunmaz. Bu nedenle MCP adresine GET isteği veya tarayıcıda doğrudan açılış HTTP 405 döndürür; bu beklenen davranıştır.

Sunulan kaynaklar ve araç

• resources/list: Ana dizinde mevcut ve okunabilir llms.txt ve AGENTS.md rehberlerini listeler.
• resources/read: Listelenen rehberlerden birini okur. Önce listeden gelen URI'yi kullanın; başka dosya veya dış URL okunamaz.
• tools/list: Kullanılabilir araç tanımını verir.
• tools/call ve build_blog_search_url: query alanındaki kısa konu için blog arama bağlantısı oluşturur. Sonuç yazılarını okumaz ve tıbbi yanıt üretmez.
• ping: Protokol bağlantı kontrolüdür.

İstek gövdesi en fazla 64 KiB, tek kaynak okuması en fazla 128 KiB olabilir. Arama konusu boş olamaz; en fazla 160 karakterdir. Sitede yazıların değişmesi rehber ve site haritası üzerinden izlenir; bu hizmet ayrı bir yazı veritabanı tutmaz.

Örnek initialize isteği

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"ornek-istemci","version":"1.0.0"}}}

Örnek araç çağrısı

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"build_blog_search_url","arguments":{"query":"boy kısalığı"}}}

Durum kontrolü

Durum kaynağı, hizmet dosyasının ve rehberlerin sunucuda mevcut ve okunabilir olup olmadığını kontrol eder. Hepsi mevcutsa HTTP 200 ve ready, eksik varsa HTTP 503 ve degraded döner. Bu yerel dosya kontrolü, initialize veya gerçek MCP istemcisiyle uçtan uca testin yerine geçmez.

Hatalar ve iletişim

Geçersiz JSON için parse hatası, izin verilmeyen kaynak için resource not found ve desteklenmeyen yöntem için method not found döndürülür. Geçersiz Origin başlığı 403, yanlış HTTP yöntemi 405, aşırı büyük istek 413 ve yanlış içerik türü 415 ile reddedilir. Sayfa içeriği ve iletişim için iletişim sayfasını, veri işleme bilgileri için gizlilik politikasını inceleyebilirsiniz.