Klinik MCP

---

title: Klinik MCP emoji: 💊 colorFrom: blue colorTo: green sdk: docker app_port: 8080 pinned: false

<p align="center"> <img src="KlinikMCP.png" alt="Klinik MCP" width="140"> </p>

<h1 align="center">Klinik MCP</h1>

<p align="center"> <b>Türk hekim ve eczacılar için ilaç & klinik bilgi MCP sunucusu.</b><br> TİTCK · SGK EK-4/A · openFDA · NLM RxNorm/RxClass · PubMed — tek araç setinde; Claude ve ChatGPT ile çalışır. </p>

<p align="center"> <a href="https://smithery.ai/server/onatozmen44/klinik-mcp"><img alt="Smithery" src="https://img.shields.io/badge/Smithery-listed-ea580c"></a> <a href="https://github.com/onatozmenn/klinik-mcp"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-source-181717?logo=github"></a> <a href="LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-22c55e"></a> <img alt="MCP" src="https://img.shields.io/badge/MCP-stdio%20%7C%20HTTP-2563eb"> <img alt="Python" src="https://img.shields.io/badge/python-3.10%2B-3776AB?logo=python&logoColor=white"> </p>

⚠️ Sorumluluk reddi: Bu sunucunun sağladığı bilgiler yalnızca eğitim amaçlıdır ve tıbbi tavsiye değildir. Tıbbi kararlar için mutlaka bir sağlık profesyoneline danışın.

Araçlar (Tools)

<details> <summary><b>19 araç — tam listeyi açmak için tıkla</b></summary>

Araç	Açıklama	Kaynak
search_drugs	İlaç adıyla (yanlış yazımlar dâhil) arama, RxCUI çözümleme	RxNorm
get_drug_label	Endikasyon, doz, uyarı, kontrendikasyon, etkileşim, yan etki	openFDA
get_drug_interactions	Etiketteki ilaç etkileşimleri bölümü	openFDA
get_drug_adverse_events	En sık bildirilen yan etkiler (FAERS)	openFDA
get_drug_recalls	Geri çağırma (recall) kayıtları	openFDA
get_rxnorm_details	Normalleştirme: etken madde ve marka adları	RxNorm
find_drugs_for_condition	Hastalığa göre ilaç bulma (ters arama)	openFDA
get_drug_classes	Terapötik / ATC / etki mekanizması sınıfları	RxClass
search_medical_literature	PubMed'de tıbbi literatür araması	PubMed
creatinine_clearance	Kreatinin klerensi (Cockcroft–Gault)	Formül
body_surface_area	Vücut yüzey alanı (Mosteller)	Formül
pediatric_dose	Kilo bazlı pediatrik doz hesabı	Formül
find_drug_equivalents	Eşdeğer (muadil) grup + fiyat (en ucuz)	SGK EK-4/A
get_reimbursement_status	Geri ödeme durumu (listede mi)	SGK EK-4/A
search_turkish_drugs	Türk ilaç kaydı arama (ad)	TİTCK SKRS
get_turkish_drug_info	İlaç bilgisi: ATC, firma, reçete türü	TİTCK SKRS
find_drugs_by_active_ingredient	Aynı ATC (etkin madde) ilaçlar	TİTCK SKRS
get_drug_safety_status	Ek izleme (▼) + ruhsat iptali	TİTCK
get_drug_price	TL fiyat (perakende/depocu)	Ticari export

</details>

🚀 Bağlama (kurulum gerekmez)

Sunucu yayında (HuggingFace Spaces + Smithery) — çoğu kullanıcı için hiçbir kurulum gerekmez. İstemcini seç:

ChatGPT

1. ChatGPT → Settings → Connectors → Advanced → Developer mode'u aç.
2. Add connector de ve MCP URL'sini gir:

   https://onatozmenn-klinik-mcp.hf.space/mcp
   

3. Kaydet. Artık sohbette “parol muadili nedir, en ucuzu hangisi?” gibi sorabilirsin.

Not: Özel MCP araçları yalnızca Developer mode açık hesaplarda görünür.

Claude Desktop

claude_desktop_config.json dosyasına ekle (Windows: %APPDATA%\Claude\claude_desktop_config.json · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "klinik": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://onatozmenn-klinik-mcp.hf.space/mcp"]
    }
  }
}

Claude Desktop'ı kapat-aç; araçlar 🔨 menüsünde görünür.

Smithery (tek komut)

npx -y @smithery/cli install onatozmen44/klinik-mcp --client claude

---

<details> <summary><b>🛠️ Yerel geliştirme (kendi makinende çalıştır)</b></summary>

Kendi makinende çalıştırmak veya katkıda bulunmak istersen:

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

# stdio (yerel Claude Desktop için):
.\.venv\Scripts\python.exe -m health_mcp

# HTTP (ChatGPT / uzak istemciler için):
.\.venv\Scripts\python.exe -m health_mcp --transport http --port 8000

İsteğe bağlı: .env.example'ı .env'e kopyalayıp OPENFDA_API_KEY / NCBI_API_KEY girerek API hız limitlerini yükseltebilirsin (gerekli değil).

Yereldeki stdio'yu Claude'a bağlamak istersen config'de command'i kendi .venv\Scripts\python.exe yoluna, args'ı ["-m", "health_mcp"]'e ayarla.

Araçları tarayıcıda denemek (MCP Inspector):

npx @modelcontextprotocol/inspector .\.venv\Scripts\python.exe -m health_mcp

</details>

<details> <summary><b>📚 Veri kaynakları, güncelleme & gelişmiş kullanım</b></summary>

Veri kaynakları

• openFDA — https://open.fda.gov/apis/ (ilaç etiketleri, yan etkiler, geri çağırmalar)
• NLM RxNorm / RxNav / RxClass — https://rxnav.nlm.nih.gov/ (ilaç terminolojisi ve sınıfları)
• PubMed (NCBI E-utilities) — https://www.ncbi.nlm.nih.gov/books/NBK25500/ (tıbbi literatür)

🇹🇷 Türkiye verisi (SGK EK-4/A — tam liste)

find_drug_equivalents ve get_reimbursement_status araçları, SGK'nın tam "Bedeli Ödenecek İlaçlar Listesi (EK-4/A)"sını okur (~8.000 ilaç: eşdeğer grup, barkod, kamu no, listeye giriş tarihi, geri ödeme) (src/health_mcp/data/sgk_ek4a.json).

Tam liste, SGK'nın konsolide "İşlenmiş Güncel SUT" zip'i içinde public olarak yayımlanır (EK-4 LİSTELERİ/EK-4A BEDELİ ÖDENECEK İLAÇLAR LİSTESİ.xlsx). scripts/update_data.py bunu otomatik bulur, indirir ve işler.

TL fiyatı notu: EK-4/A barkod + eşdeğer + geri ödeme içerir ama net TL perakende fiyatı içermez (fiyat sütunları iskonto oranıdır). TİTCK de barkod bazlı retail TL fiyatını public yayımlamaz (dinamikmodul/100 yalnızca EUR referans, barkodsuz). Gerçek TL fiyatı için ticari bir ilaç DB'si gerekir.

Manuel güncelleme (zip'ten çıkardığın EK-4/A ile):

.\.venv\Scripts\python.exe scripts/build_sgk_snapshot.py "C:\yol\EK-4A.xlsx" --version "2026"

🇹🇷 Tam ilaç kaydı (TİTCK SKRS)

search_turkish_drugs, get_turkish_drug_info ve find_drugs_by_active_ingredient araçları, TITCK SKRS E-Reçete listesinin tüm aktif ürünlerini (~7.900 ilaç: ad, barkod, ATC, firma, reçete türü, temel ilaç listesi) okur (src/health_mcp/data/titck_drugs.json).

Listeyi güncellemek için:

1. En güncel .xlsx'i indir: titck.gov.tr → dinamikmodul/43 "SKRS E-Reçete İlaç ve Diğer Farmasötik Ürünler Listesi".
2. Snapshot'ı üret:

.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
.\.venv\Scripts\python.exe scripts/build_titck_snapshot.py "C:\yol\skrs.xlsx" --version 2026-06-23

🛡️ TİTCK güvenlik durumu (ek izleme + ruhsat iptali)

get_drug_safety_status aracı ve get_turkish_drug_info içindeki uyarı satırları, iki resmî TİTCK listesini okur (src/health_mcp/data/titck_safety.json):

• Ek İzlemeye Tabi İlaçlar (▼ kara üçgen) — TİTCK dinamikmodul/57
• Ruhsat İptal Listesi — TİTCK dinamikmodul/76

Eşleşme ilaç adı/etkin madde bazlıdır (ruhsat iptalinde barkod çoğu kayıtta boştur), bu yüzden ürün/sunum farkları için resmî listeden teyit edilmelidir. Listeyi güncellemek için en güncel .xlsx'leri indirip:

.\.venv\Scripts\python.exe scripts/build_titck_safety_snapshot.py `
  --monitoring "C:\yol\ekizleme.xlsx" --cancellations "C:\yol\ruhsatiptal.xlsx" `
  --monitoring-version 2025-12-19 --cancellations-version 2026-06-19

veya tek komutla otomatik (aşağıdaki scripts/update_data.py bunu da çeker).

🔄 Otomatik güncelleme

TİTCK listesi düzenli güncellenir. En güncel veriyi tek komutla çek:

.\.venv\Scripts\python.exe scripts/update_data.py

Script TİTCK SKRS listesini (titck_drugs.json), SGK tam EK-4/A'yı (sgk_ek4a.json, konsolide SUT zip'inden) ve TİTCK güvenlik listelerini (titck_safety.json: ek izleme + ruhsat iptali) kendi bulup indirir ve yeniden üretir. Haftalık zamanlamak için (yolları kendine göre düzenle):

schtasks /Create /SC WEEKLY /D MON /ST 03:00 /TN "health-mcp-update" /TR "C:\yol\.venv\Scripts\python.exe C:\yol\scripts\update_data.py"

💰 TL fiyatı (takılabilir entegrasyon)

Net TL perakende fiyatı ücretsiz/public olarak yok (SGK EK-4/A iskonto oranı, TİTCK yalnızca EUR referans). Bu yüzden fiyat takılabilir bir kaynaktan gelir: get_drug_price ve find_drug_equivalents (en ucuz eşdeğer), barkod→TL fiyatı src/health_mcp/data/prices.json'dan okur.

Varsayılan olarak fiyat verisi gelmez — hiçbir sahte değer gösterilmez; gerçek bir kaynak yüklenene kadar araçlar fiyatı sessizce atlar. Gerçek fiyatı yüklemek için herhangi bir ticari/eczane kaynağından (Rxmediapharma, eczane otomasyonu, ticari CSV) barkod + perakende fiyat dışa aktarıp:

.\.venv\Scripts\python.exe scripts/build_prices.py "C:\yol\fiyatlar.csv" --source "Rxmediapharma" --version 2026-06

Script barkod/perakende/depocu sütunlarını otomatik bulur (CSV veya Excel). Fiyat kaynağı yoksa araçlar fiyatı sessizce atlar.

</details>