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

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)
• DDInter 2.0 — https://ddinter.scbdd.com/ (ikili ilaç-ilaç etkileşim; CC BY-NC-SA 4.0, yalnızca ticari olmayan kullanım)

🇹🇷 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"