Skip to main content
Glama

ilac-mcp

test

Türkiye'de ruhsatlı beşeri ilaçlar için TİTCK verisini yapay zekâ asistanlarına açan bir Model Context Protocol sunucusu.

An MCP server exposing Turkish Medicines and Medical Devices Agency (TİTCK) drug lists: search, generic equivalents, licence and e-prescription status.

⚠️ Tıbbi tavsiye değildir. Veriler TİTCK'nın kamuya açık listelerinden derlenir. İlaç kullanımı veya değişikliği için hekim ya da eczacıya danışın.

Neler yapabilir?

Araç

Açıklama

ilac_ara

Ürün adı, etkin madde, barkod ya da ATC koduyla arama. Türkçe karakter ve büyük/küçük harf fark etmez.

ilac_detay

Barkodla tek ürün: ruhsat no/tarihi, askı durumu, reçete türü, temel ilaç listeleri.

esdeger_bul

Aynı ATC kodu, aynı doz ve aynı form grubundaki ürünler; diğer doz/formlar ayrıca listelenir.

haftalik_degisiklikler

Son e-reçete listesinde yeni eklenen ve değişen ürünler.

veri_guncelle

TİTCK'dan güncel listeleri indirip yerel veritabanını yeniden kurar.

veri_durumu

Yerel verinin hangi tarihli listelerden kurulduğu.

Örnek sorular: "Parol 500 mg tabletin eşdeğerleri neler?", "8699522095650 barkodlu ilaç e-reçetede aktif mi?", "Bu hafta e-reçete listesine hangi ilaçlar eklendi?"

Related MCP server: mcp-aemps

Kurulum

uv gerekir.

git clone https://github.com/dckaratas/ilac-mcp
cd ilac-mcp
uv run ilac-mcp sync    # TİTCK listelerini indirir (~4 MB, ~20 sn)

Claude Desktop / Cursor / VS Code

İstemcinin MCP yapılandırmasına ekleyin (yolu kendi klasörünüzle değiştirin):

{
  "mcpServers": {
    "ilac": {
      "command": "uv",
      "args": ["run", "--directory", "C:\\Dev\\mcp\\ilac-mcp", "ilac-mcp"]
    }
  }
}

İlk çağrıda veri yoksa sunucu listeleri kendisi indirir.

Komut satırı

uv run ilac-mcp ara "majezik"
uv run ilac-mcp sync

Veri kaynakları

Liste

Güncellenme

Kullanılan alanlar

Ruhsatlı Beşeri Tıbbi Ürünler Listesi

Haftalık (cuma)

Barkod, ürün adı, etkin madde, ATC, ruhsat sahibi/no/tarihi, askı durumu

SKRS E-Reçete İlaç Listesi

Haftalık (salı)

Aktif/pasif, reçete türü, ATC adı, temel ilaç listeleri, haftalık değişiklikler

İki liste barkod üzerinden birleştirilir. Veri yerelde saklanır (Windows: %LOCALAPPDATA%\ilac-mcp); konumu ILAC_MCP_DATA_DIR ortam değişkeniyle değiştirilebilir.

Veri ve lisans

Bu repo yalnızca kodu içerir ve MIT lisanslıdır. TİTCK verisi repoda dağıtılmaz; her kullanıcının makinesinde doğrudan titck.gov.tr'den indirilir. Yanıtlar kaynak ve liste tarihini içerir.

Bilinen sınırlar

  • Eşdeğerlik sezgiseldir. Doz ve form ürün adından çıkarılır; ürünlerin ~%28'inde doz, ~%19'unda form tespit edilemiyor. Bu ürünler farkli_doz altında görünür.

  • Fiyat yok. TİTCK'nın güncel fiyat listesi giriş gerektiriyor; kamuya açık referans fiyat listesi düzensiz yayımlanıyor.

  • Prospektüs (KT/KÜB) henüz yok. Yol haritasında.

Yol haritası

  • KT/KÜB metinlerinden bölüm getirme (endikasyon, doz, yan etki, uyarılar)

  • Referans fiyat listesi ve fiyat geçmişi

  • Ruhsat iptal listesi ve geri çekme duyuruları

  • PyPI yayını (uvx ilac-mcp)

Geliştirme

uv run pytest
git config core.hooksPath .githooks   # commit öncesi kontrolleri etkinleştirir (bir kez)

Commit öncesi kanca; anahtar/secret dosyalarını ve TİTCK verisini engeller, gitleaks ile secret taraması yapar ve testleri çalıştırır. gitleaks'in PATH'te olması gerekir. CI aynı taramayı tüm git geçmişi üzerinde tekrarlar.

Testler gerçek TİTCK dosyalarının başlık ve sayfa yapısını taklit eden küçük örnek dosyalar kullanır.

Available Tools

6 tools
esdeger_bulA
Read-only

Bir ilacın eşdeğerlerini bulur: aynı ATC kodu ve aynı doz.

"farkli_doz" aynı etkin maddenin başka dozlarını içerir. Farmasötik form ve
SGK geri ödeme durumu ayrıca kontrol edilmelidir.

Inputs: barkod (required), sadece_aktif. Returns: object

haftalik_degisikliklerB
Read-only

Son e-reçete listesinde yeni eklenen ve değişiklik yapılan ürünleri listeler.

Inputs: no named parameters. Returns: object

ilac_araA
Read-only

İlaç arar. Sorgu ürün adı, etkin madde, barkod (8-14 hane) ya da ATC kodu (ör. N02BE01) olabilir.

Türkçe karakterler ve büyük/küçük harf fark etmez. Aktif ürünler önce listelenir.

Inputs: sorgu (required), limit, sadece_aktif. Returns: object

ilac_detayA
Read-only

Barkodla tek bir ilacın tüm bilgilerini getirir: ruhsat, askı durumu, reçete türü, temel ilaç listeleri.

Inputs: barkod (required). Returns: object

veri_durumuA
Read-only

Yerel verinin hangi tarihli TİTCK listelerinden kurulduğunu gösterir.

Inputs: no named parameters. Returns: object

veri_guncelleA
Idempotent

TİTCK'dan en güncel listeleri indirip yerel veritabanını yeniden kurar (yaklaşık 4 MB indirme).

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool has a recognizable focus: free-text lookup (ilac_ara), single-record detail by barcode (ilac_detay), equivalence lookup (esdeger_bul), change feed, and data maintenance. The main soft overlap is that ilac_ara also accepts barcodes/ATC codes, which can make it a tempting substitute for ilac_detay or esdeger_bul, but the descriptions make the intended split clear.

    Naming Consistency4/5

    All names are lowercase snake_case with a noun-then-action/qualifier shape (ilac_ara, ilac_detay, veri_guncelle, veri_durumu), and the shared ilac_/veri_ prefixes group related tools. Two tools (esdeger_bul, haftalik_degisiklikler) break the prefix grouping, which is a minor deviation rather than an inconsistency.

    Tool Count5/5

    Six tools is a tight, purposeful set for a drug-lookup server: one search, one detail, one equivalence helper, one change feed, and two data-lifecycle tools. Nothing appears redundant and no obvious step of the workflow is missing a tool.

    Completeness4/5

    The surface covers the core lifecycle well: query, single-record inspection, equivalent-drug discovery, change tracking, and data freshness/refresh. Gaps are minor — there is no way to browse or filter lists (e.g. by prescription type, SGK reimbursement, or active-ingredient-only enumeration) other than free-text search.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides access to the official FDA DailyMed database for comprehensive drug information, including drug labels, NDC codes, RxNorm mappings, pharmacologic classifications, and FDA application numbers through natural language queries.
      28
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to query the official Spanish AEMPS/CIMA registry for real-time pharmaceutical data, including medications, supply problems, and clinical equivalences.
      40 PyPI
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI agents with comprehensive access to Israel's complete pharmaceutical database from the Ministry of Health, enabling drug information search, therapeutic comparisons, and safety assessments.
      19
      Creative Commons Attribution Non Commercial Share Alike 4.0 International
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables drug safety, interactions, adverse events, and regulatory data queries using free sources like DrugBank, WHO, FDA FAERS, and more. Provides tools for checking drugs, interactions, adverse events, and searching across pharmaceutical databases.
      MIT