Doktor

Doktor MCP

Beta sürüm — Güncel sürüm için package.json ve CHANGELOG.md dosyalarına bakın.

Proje sayfası: avfatihsozer.com/projeler/doktor-mcp · English: README.en.md

doktor-mcp, hekimlere yönelik kaynak-temelli hukuki bilgilendirme paketleri üreten, bağımsız bir TypeScript/Node.js MCP iskeletidir. Kategorik nihai hukuki görüş vermez ve hekime ne yapacağını söylemez. Soruları resmî mevzuat metniyle ve gerekçeli yüksek mahkeme karar metniyle eşleştirir; kesin hüküm vermeden, kaynağa dayalı koşullu değerlendirmeler (ör. "kaynaklar bu yönde eğilim göstermektedir") sunabilir.

Adaptör sınırları şunlar için hazırlanmıştır:

• legislation (mevzuat)
• yargitay
• danistay
• aym

Genel internet makaleleri, bloglar, haberler, hukuk bürosu tanıtım sayfaları ve forumlar bu projenin kaynak girdileri değildir.

Kaynak Motoru Aktarımı (Source Engine Port)

Kaynak-motoru katmanı, canlı adaptörlerin ihtiyaç duyduğu sağlamlaştırmayı sağlar:

• Bedesten istekleri; sınırlı yeniden deneme, Retry-After işleme, üstel geri-çekilme (backoff), titreşim (jitter) ve istek telemetrisi içeren paylaşılan bir HttpClient ve RateLimiter yolu kullanır.
• Canlı kaynak hataları yapılandırılmış ve yalnızca-JSON kalır. Kaynak tanılaması; CLI JSON çıktısına log yazmadan yeniden deneme sayısı, backoff süresi, durum ve içerik tipini taşıyabilir.
• src/sources/sourceRegistry.ts, mevzuat ve emsal kaynakları için sadeleştirilmiş kaynak yeteneği, hız limiti ve önbellek politikası meta verisini sunar.
• Bedesten/Yargıtay adaptörleri yalnızca-meta veri içeren kararları doğrulanmış emsal çıktısından uzak tutar; resmî mevzuat ise resmî arama, doküman getirme veya madde çıkarımı bir alıntıyı destekleyemediğinde yapılandırılmış unavailable sonuç döndürür.

Canlı Mevzuat Durumu

Canlı resmî mevzuat adaptörü, opsiyonel MCP araç akışlarına bağlanmıştır:

• adaptör: LiveOfficialLegislationAdapter
• resmî kaynak: T.C. Cumhurbaşkanlığı Mevzuat Bilgi Sistemi — mevzuat.gov.tr
• arama yeteneği: resmî MevzuatDatatable arama isteği ayrıştırıcısı
• tam-metin yeteneği: resmî MevzuatMetin doküman getirme
• mevcut çıkarım kanıtı: eşlenmiş mevzuat için PDF metin çıkarımı ve madde ayrıştırma

Sağlık mevzuatı ilk canlı eşleme yoludur. Hasta hakları ve aydınlatılmış onam soruları, Hasta Hakları Yönetmeliği 4847 için resmî üretilmiş PDF yolunu kullanır (eşlenmiş madde 24 ve 26 dahil). Sağlık hukuku eşlemeleri ayrıca Tıbbi Deontoloji Nizamnamesi, Tababet ve Şuabatı San'atlarının Tarzı İcrasına Dair Kanun ve Sağlık Hizmetleri Temel Kanunu'nu da kapsar. KVKK madde 6, kişisel-sağlık-verisi ve mahremiyet soruları için, sağlığa özel kaynaklardan sonra destekleyici genel mevzuat olarak kullanılabilir.

Resmî bir doküman çıkarılabilir bir formatta gelmediğinde veya eşlenmiş bir madde çıkarılamadığında, canlı adaptör bir hüküm üretmek yerine yapılandırılmış unavailable çıktısı döndürür.

Canlı kaynak hataları şu sözleşmeyi kullanır:

{

"status": "unavailable", "source": "mevzuat.gov.tr", "errorCode": "provision_not_found", "message": "Official text was retrieved but the mapped article could not be extracted.", "retryable": false, "recommendedNextStep": "Inspect the official text parser before using this provision in an answer." }

MVP Kapsamı

İskelet şunları içerir:

• MCP sunucu kaydı ve araç işleyici iskelesi
• resmî mevzuat delili, mahkeme kararı delili, sınıflandırma, emsal durumu ve hukuki bilgilendirme paketi için tip sözleşmeleri
• mock mevzuat ve yüksek mahkeme adaptörleri
• resmî kaynak doğrulaması için canlı resmî mevzuat adaptörü
• canlı mevzuat için MCP sourceMode yönlendirmesi
• sağlık-öncelikli mevzuat eşlemeleri ve kaynak izleme (source trace) meta verisi
• sağlık hukuku boru hattı parçaları:
• soru sınıflandırıcı
• mevzuat eşleyici
• emsal filtresi
• cevap derleyici
• yerel JSON smoke komutu
• ilk kaynak-güvenliği kuralları için Vitest kapsamı

Emsal filtresi şu an şu durumları sunar:

• precedent_usable: tam metin, hukuki gerekçe ve olay ilgililiği mevcut
• limited_value: tam metin var ama ilgililik zayıf
• procedural_only: esasa ilişkin gerekçe yok; usuli metin, salt onama veya salt bozma
• metadata_only: tam metin olmadan künye meta verisi
• no_reasoning: tam metin var ama hukuki gerekçe yok

Derlenen pakette doğrulanmış emsal bölümüne yalnızca precedent_usable kayıtları girer.

Yanıt Sözleşmesi (Response Contract)

Tüm araç yanıtları dataOrigin alanı taşır. Bu alan, yanıtın kaynağını belirtir:

dataOrigin: "mock" olduğunda, yanıt ayrıca mockDataWarning alanı taşır:

{

"dataOrigin": "mock", "mockDataWarning": "BU YANIT KURGU (FIXTURE) VERİSİDİR. Gerçek mevzuat veya mahkeme kararı DEĞİLDİR. Gerçek kaynaklar için sourceMode: 'live' kullanın." }

Bu uyarı, mock verinin gerçek mevzuat alıntısı gibi görünmesini önlemek için kaçırılamaz şekilde eklenmiştir. shortAnswer gibi hekime-dönük metin alanlarına ek önek eklenmez; üst-seviye dataOrigin ve mockDataWarning alanları yeterlidir.

prepare_doctor_legal_information_pack yanıtı ayrıca bir packId alanı taşır. Bu, "pack-" önekiyle başlayan 6 haneli bir hex kimliktir (ör. "pack-3f9a2c"). drill_down_pack_item aracına packId ileterek paketi yeniden oluşturmadan belirli bir madde veya kararı detaylandırabilirsiniz. packId, sunucu belleğinde 30 dakika süreyle saklanır.

Yapılandırılmış paket, istenen hekime-dönük bölümler etrafında şekillenir:

1. shortAnswer
2. legalClassification

• criminal
• civilCompensation
• disciplinaryAdministrative
• patientRights
• privacyKvkk
• professionalEthics

1. relevantLegislation

• mevzuat adı
• madde numarası
• kaynak hükümden birebir kopyalanmış alıntı
• olay bağlantısı

1. verifiedHighCourtPrecedents

• mahkeme/daire, tarih, esas/karar numaraları
• olay özeti, hukuki değerlendirme, sonuç
• benzerlik/farklılık notu

1. missingInformation
2. lawyerReviewPoints

Her mevzuat girdisi bir kaynak doküman id'si ve birebir kaynak alıntısı taşır. Her doğrulanmış emsal girdisi, gerekçeli-emsal filtresinden geçmek zorundadır.

Bilinçli Olarak Kapsam Dışı

MVP şunları içermez:

• canlı AYM yüksek mahkeme istemcisi (AYM kararlar bilgi bankası HTML-only arayüzdür; JSON API yoktur — synthetic_only işaretlidir)
• kaynak referansı veya koşullu dil olmaksızın kategorik risk seviyesi puanlaması ("risk seviyesi yüksek/düşük")
• acil eylem talimatları
• dilekçe veya savunma yazımı
• nihai hukuki sonuçlar
• "sorumluluk vardır" veya "sorumluluk yoktur" gibi kategorik ifadeler
• Araç, kaynağa dayalı koşullu değerlendirmeler (ör. "kaynaklar şu yönde eğilim gösteriyor") sunabilir; ama asla kategorik nihai hüküm vermez
• MCP kaynak kayıtlarıyla doğrulanmamış, yalnızca-modele dayalı hukuki önermeler

v0.44.0'da Yeni

• `assessmentTone`: Opsiyonel parametre ("strict" | "grounded-advisory", varsayılan: "grounded-advisory"). strict modda yalnızca kaynak listeleri döner (değerlendirme yok). grounded-advisory modda, kaynağa dayalı koşullu değerlendirme içeren bir preliminaryAssessment eklenir.
• `preliminaryAssessment`: summary ve sentences[] içeren opsiyonel yanıt alanı. Her cümlede text, sourceRef ve sourceLabel bulunur. Cümleler emsallerden gerçek sonuç/gerekçeyi ve mevzuattan birebir alıntı parçalarını kullanır — asla kalıp (boilerplate) değil.
• Mevzuat yürürlük meta verisi: Hükümler inForce, lastAmendedDate ve repealed alanları taşır (varsayılan olarak asla "yürürlükte" varsaymaz).
• Karar deduplikasyonu: Çapraz-kaynak tekrarları (ör. aynı kararın Yargıtay ve Bedesten'den gelmesi) deduplike edilir; en zengin sürüm tutulur.
• Tam Türkçe diakritik politikası: Tüm hekime-dönük metinler doğru Türkçe karakterleri kullanır (ASCII ikamesi yok).
• Tam sürüm geçmişi için CHANGELOG.md. Kararlılık katmanları için COMPATIBILITY.md.

Hız limiti canlı istemciler için ayrılmıştır: amaçlanan davranış, gerçek bir blok veya kaynak hatasından sonra adaptif backoff ile pratik kamu-kaynağı trafiğidir; baskı kanıtı olmadan agresif bir kısıtlama değildir.

MCP Araçları

• classify_medical_legal_question
• search_health_legislation
• get_legislation_provisions
• search_health_precedents
• filter_reasoned_precedents
• prepare_doctor_legal_information_pack
• drill_down_pack_item — Takip sorusu: packId ile paketi yeniden oluşturmadan belirli bir madde/kararı detaylandırır. Örnek: { "packId": "pack-3f9a2c", "followUpQuestion": "madde 24 ne diyor?" }
• get_decision_full_text — Belirli bir mahkeme kararının tam metnini getirir. Örnek: { "documentId": "yargitay:99001", "sourceMode": "live" }

Yanıt Sözleşmesi Notları

Tüm araç yanıtları dataOrigin alanı taşır ("mock", "live", "snapshot", "computed", "client-provided"). Mock modda mockDataWarning alanı eklenir.

prepare_doctor_legal_information_pack çağrısında includeDiagnostics: true parametresi eklenerek tam denetim izi (seçim tanılaması, kaynak izi vb.) alınabilir.

Mevzuata-dönük MCP girdileri opsiyonel sourceMode kabul eder:

{

"question": "kişisel sağlık verisi mahremiyet", "sourceMode": "live" }

sourceMode varsayılan olarak "live"'dır (0.59.0'dan beri); fixture verisi için "mock" açıkça istenmelidir. search_health_legislation, get_legislation_provisions ve prepare_doctor_legal_information_pack "live" kullanabilir. Canlı bilgilendirme paketi aynı MVP şeklini korur ve sourceUnavailable'ı yalnızca resmî mevzuat kaynağı doğrulanmış bir hüküm döndüremediğinde ekler.

Mock mod yerel fixture hükümlerini kullanır. Canlı mod, mevzuat.gov.tr'den resmî mevzuat metnini, ayrıca canlı Yargıtay ve Danıştay emsal adaptörlerini kullanır. AYM yalnızca-mock'tur ve canlı modda bir geri-dönüş (fallback) olarak kullanılmak yerine devre dışı bırakılır.

Sağlık Mevzuatı Önceliği

Canlı eşleme katmanı hekim sorularını sağlık-hukuku konu kümelerine ayırır:

• aydınlatılmış onam / onam
• tıbbi müdahale
• hasta hakları
• hasta mahremiyeti
• kişisel sağlık verisi
• kayıt, dosya ve epikriz
• acil müdahale
• sevk ve konsültasyon
• hekimin özen yükümlülüğü
• meslek etiği

Her eşleme; hedef mevzuatı, hedef madde numaralarını, arama terimlerini, bir seçim gerekçesini ve bir sağlık-hukuku önceliğini taşır. Birden çok eşleme uyduğunda, paket birincil sağlık mevzuatını destekleyici genel mevzuattan önce sıralar. Örneğin bir kişisel-sağlık-verisi mahremiyet sorusu, KVKK'dan önce Hasta Hakları Yönetmeliği'ni döndürebilir; KVKK, ilgisiz hekim soruları için geniş bir geri-dönüş olarak kullanılmaz.

Kaynak İzleme (Source Trace)

sourceTrace, hukuki gerekçe sağlamak yerine canlı mevzuat çıktısını denetler. Her iz, bir hükmün sağlık-hukuku eşlemesinden resmî dokümana ve madde çıkarım adımına nasıl geçtiğini gösterir:

• orijinal query
• matchedHealthMapping ve eşleme olmadığında denenen eşleme adayları
• officialSearchRequest, resmî arama sonuç sayısı ve kompakt resmî sonuçlar
• selectedSearchResult ve selectedResultReason
• landing/detay URL'i ve doğrudan ya da üretilmiş PDF URL'i
• contentType, çıkarım yöntemi, çıkarılan madde numaraları ve getirme süresi

Canlı search_health_legislation, seçilen hükümlerin yan