MEDAS MCP (Hâlâ geliştirme aşamasında!)

TÜİK MEDAS (Türkiye İstatistik Kurumu göstergeleri) için MCP sunucusu.

Özellikler

• 92 konu — TÜİK'in tüm istatistik kategorileri

• 400+ gösterge — anında önbelleğe alınır, canlı yedek mevcuttur

• Dinamik keşif — 0 sabit kodlanmış widget kimliği, arayüz değişikliklerine uyarlanır

• Önce önbellek — list_topics/get_indicators/download tümü önbellekten <50ms

• İkili XLS — xlwt CDFV2 Excel çıktısı (MEDAS pivot.xls ile aynı format)

• Akıllı basamaklama — zorunlu kırılımları otomatik seçer (COICOP, SITC, vb.)

• ZK Widget API — zk.Widget.$().fire() ile sağlam kırılım yönetimi

GXP blocks remain.

I'll now write the final output.# MEDAS MCP (Hâlâ geliştirme aşamasında!)

TÜİK MEDAS (Türkiye İstatistik Kurumu göstergeleri) için MCP sunucusu.

Related MCP server: turkiye-veri-mcp

Özellikler

• 92 konu — TÜİK'in tüm istatistik kategorileri

• 400+ gösterge — anında önbelleğe alınır, canlı yedek mevcuttur

• Dinamik keşif — 0 sabit kodlanmış widget kimliği, arayüz değişikliklerine uyum sağlar

• Önce önbellek — list_topics/get_indicators/download tümü önbellekten <50ms

• İkili XLS — xlwt CDFV2 Excel çıktısı (MEDAS pivot.xls ile aynı format)

• Akıllı basamaklama — zorunlu kırılımları otomatik seçer (COICOP, SITC, vb.)

• ZK Widget API — zk.Widget.$().fire() ile sağlam kırılım yönetimi

Kurulum

pip install playwright xlwt httpx
playwright install chromium

Veya uv ile:

uv pip install -e .
playwright install chromium

Kullanım

MCP sunucusu olarak (stdio)

python server.py

Pi entegrasyonu

~/.pi/config.json dosyasına ekleyin:

{
  "extensions": {
    "medas": {
      "command": "python",
      "args": ["/path/to/medas_mcp/server.py"],
      "cwd": "/path/to/medas_mcp"
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "medas": {
      "command": "python",
      "args": ["/path/to/medas_mcp/server.py"]
    }
  }
}

Araçlar

Örnek akış

1. list_topics("fiyat") → [{index:78, label:"Tüketici Fiyat Endeksi"}]
2. get_indicators(78) → {count:12, indicators:[...]}
3. download(78, format="xls") → /tmp/MEDAS_Tüketici_Fiyat_Endeksi_20260820.xls

Mimari

AI Agent  ⇄  MCP (stdio)  ⇄  server.py  ⇄  medas_client.py
                                            ├─ cache (data/*.json) → instant
                                            └─ Playwright (live=true) → ZK AU protocol

Önbellek vs Canlı

Dosyalar

medas_mcp/
├── server.py              # MCP server (3 tools)
├── medas_client.py        # Hybrid client (cache + live Playwright)
├── KNOWHOW.md             # ZK AU protocol traffic notes
├── AGENTS.md              # AI agent instructions
├── README.md              # This file
├── pyproject.toml         # Package metadata
├── .gitignore
└── data/
    ├── topic_mapping.json  # 92 topics with URLs
    ├── topic_gosterge.json # Indicators + cascading branches
    └── medas_unified.json  # Unified dataset

ZK AU Protokolü

• dtid + toplu cmd_n=onSelect/onClick ile POST /medas/zkau;jsessionid=XXX

• Widget kimlikleri her oturumda değişir — DOM üzerinden dinamik olarak keşfedilir

• Basamaklama: zk.Widget.$().fire('onSelect', {items:[itemId], reference:itemId})

Lisans

MIT