EVDS MCP 经济数据服务器

Resmi EVDS-MCP Sunucusu

Resmi sunucuya ait bilgilere bu bağlantıdan erişebilirsiniz.

Repo arşiv amacıyla bırakılmıştır, ekonometrik modeller harici güncellenme planlanmamaktadır.

EVDS MCP Sunucusu

TCMB Elektronik Veri Dağıtım Sistemi (EVDS) için Model Context Protocol sunucusu. Becerilere kıyasla daha öngörülebilir düzende çıktı sunar.

Claude, GPT ve diğer LLM'ler üzerinden doğal dilde TCMB verilerine erişim sağlar. Döviz kurları, enflasyon, faiz, GSYH, cari denge ve binlerce ekonomik seriye ulaşımı kolaylaştırır.

Mevcut tüm veri gruplarının ve serilerin güncel dökümü için: data/datagroups.csv ve data/series.csv.

Kurulum

EVDS sitesinden ücretsiz API anahtarı alın, ardından tek komutla kurun.

claude mcp add -e EVDS_API_KEY=ANAHTARINIZ evds-mcp -- uvx --from git+https://github.com/orhoncan/evds-mcp evds-mcp

API anahtarını config dosyasında tutmayı tercih ederseniz:

echo '{"api_key": "ANAHTARINIZ"}' > ~/.evds-mcp.json
claude mcp add evds-mcp -- uvx --from git+https://github.com/orhoncan/evds-mcp evds-mcp

Her ikisi de tanımlıysa EVDS_API_KEY ortam değişkeni öncelik alır.

Claude Desktop / Kaynak koddan çalıştırma

Claude Desktop

claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "evds-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/orhoncan/evds-mcp", "evds-mcp"],
      "env": {
        "EVDS_API_KEY": "ANAHTARINIZ"
      }
    }
  }
}

Kaynak Koddan Çalıştırma

git clone https://github.com/orhoncan/evds-mcp.git
cd evds-mcp
uv sync
uv run evds-mcp

Claude'dan vb. İsteme

Doğrudan repo bağlantısını paylaşarak Claude'dan ya da diğer sağlayıcılardan kurulum yapmasını isteyebilirsiniz.

Araçlar

Kullanım Örnekleri

Seri Arama

> evds_ara("usd")
→ TP.DK.USD.A - USD/TRY

> evds_ara("enflasyon")
→ TP.FG.J0 - TÜFE Genel Endeks (2003=100)

Popüler aramalar (usd, eur, altın, faiz, enflasyon, gsyh, işsizlik, cari açık, rezerv vb.) API'ye gitmeden anında sonuç döner. Bu liste zamanla genişleyecek ama ne kadar net yönlendirirseniz o kadar verimli çalışır. Bazı sık kullanılan kelimeler çok uzun listeler döndürdüğü için performans kaybı olabiliyor.

Veri Çekme

> evds_cek(["TP.DK.USD.A"], baslangic="01-01-2025", bitis="28-03-2026")
→ 29 gözlem, günlük USD/TRY kurları

> evds_cek(["TP.FG.J0"], frekans="aylik", formul="yillik_yuzde")
→ Yıllık TÜFE (%)

Frekans: gunluk, isgunu, haftalik, ayda2, aylik, ceyreklik, 6aylik, yillik Formül: duzey, yuzde_degisim, fark, yillik_yuzde, yillik_fark, yilsonu_yuzde, yilsonu_fark, hareketli_ort, hareketli_toplam

Analiz

> evds_analiz(["TP.FG.J0"], analiz_turu="ozet")
→ Tanımlayıcı istatistikler + trend tespiti

> evds_analiz(["TP.DK.USD.A", "TP.FG.J0"], analiz_turu="korelasyon")
→ Korelasyon matrisi + sözel yorumlama
ya da aynı sonuç için;
> USD alış kuru ile TÜFE arasında son 1 yıllık korelasyona bak.
→ Korelasyon matrisi + sözel yorumlama

> evds_analiz(["TP.FG.J0"], analiz_turu="arima", parametreler={"tahmin_donemi": 6})
→ ARIMA/SARIMA tahmini + güven aralıkları

Analiz türleri:

• ozet - Ortalama, std, min/max, trend
• degisim - Yüzde değişim (aylık/yıllık/dönemsel)
• korelasyon - Pearson/Spearman korelasyon matrisi
• ols - OLS regresyon (R², F-testi, Durbin-Watson)
• arima - ARIMA/SARIMA tahmin + güven aralıkları
• baglam - Tek seri için MoM/YoY, min/max, trend ve dip noktası (aylık seriler)

Veri Kataloğu

EVDS'in yapısı kategori → veri grubu → seri şeklinde. data/ altında iki statik döküm var:

series.csv 9 MB olduğu için tarayıcıda açmak yerine grep'lemek daha pratik:

grep -i "konut fiyat" data/series.csv
grep "^TP.DK.USD" data/series.csv

Ekran Görüntüleri

Yapılacaklar

• Serilerin aranması ve kullanılması konusunda iyileştirmeler
• Ekonometrik modellerin çeşitlendirilmesi

Testler

uv sync --extra dev
uv run pytest

Gereksinimler

• Python ≥ 3.10
• uv (önerilen) veya pip
• TCMB EVDS API anahtarı (ücretsiz)

Lisans

MIT