ilac-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ilac-mcp Parol 500 mg tabletin eşdeğerleri neler?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ilac-mcp
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 |
| Ürün adı, etkin madde, barkod ya da ATC koduyla arama. Türkçe karakter ve büyük/küçük harf fark etmez. |
| Barkodla tek ürün: ruhsat no/tarihi, askı durumu, reçete türü, temel ilaç listeleri. |
| Aynı ATC kodu, aynı doz ve aynı form grubundaki ürünler; diğer doz/formlar ayrıca listelenir. |
| Son e-reçete listesinde yeni eklenen ve değişen ürünler. |
| TİTCK'dan güncel listeleri indirip yerel veritabanını yeniden kurar. |
| 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 syncVeri kaynakları
Liste | Güncellenme | Kullanılan alanlar |
Haftalık (cuma) | Barkod, ürün adı, etkin madde, ATC, ruhsat sahibi/no/tarihi, askı durumu | |
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_dozaltı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 toolsesdeger_bulARead-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_degisikliklerBRead-only
Son e-reçete listesinde yeni eklenen ve değişiklik yapılan ürünleri listeler.
Inputs: no named parameters. Returns: object
ilac_araARead-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_detayARead-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_durumuARead-only
Yerel verinin hangi tarihli TİTCK listelerinden kurulduğunu gösterir.
Inputs: no named parameters. Returns: object
veri_guncelleAIdempotent
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
Scored across 6 tools
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.
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.
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.
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
Turkey data API for AI agents: 40 tools + search/call for 230+ endpoints. Addresses (provinces, districts, postal codes, boundaries), validation (IBAN, tax ID/VKN, TCKN, phone, barcode), tax and salary calculators, Official Gazette, exchange rates, gold, crypto, economic indicators, prayer times, holidays and business days, weather, air quality, earthquakes, dam levels, fuel prices, EV charging, power outages, tolls, pharmacies on duty, football standings. Turkish JSON, free plan.
Medicine names, label text, safety reports, recalls, shortages and approvals from regulators
Live US drug acquisition costs (CMS NADAC) for AI assistants. Free, no auth, weekly data.
Free health AI: drug interaction checks, medicine facts and health questions in 90+ languages
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides 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.283MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query the official Spanish AEMPS/CIMA registry for real-time pharmaceutical data, including medications, supply problems, and clinical equivalences.40 PyPI1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides 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.19Creative Commons Attribution Non Commercial Share Alike 4.0 International
- AlicenseNot gradedqualityDmaintenanceEnables 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