Skip to main content
Glama

BDDK MCP Sunucusu

English | Güncel durum | Belge indeksi | Güvenlik

CI

Banka içindeki bir yapay zeka asistanının, BDDK karar, düzenleme ve bülten sorularını modelin hafızasından değil, yayımlanmış kaynaklardan cevaplaması için kurulmuş bir MCP sunucusudur.

IMPORTANT

Bu depo mühendislik betasıdır. Hukuki görüş, "bu olaya bu madde uygulanır" kararı veya bankanın üretim kabulü değildir. Sayılar ve sınırlargüncel durum belgesindedir. Güvenlik açığını herkese açık issue ile değil, güvenlik politikası ile bildirin. Katkı kuralları CONTRIBUTING.md dosyasındadır.

Bankada ne işe yarar?

Teftiş, uyum, iç denetim ve bu işi asistana bağlayan teknik ekip içindir. Halka açık bir tüketici uygulaması değildir.

Asistan şunları sorabilir:

  • Bir kararın veya düzenlemenin kaydını bulmak

  • Yayımlanmış metnin içinde aramak ve bir maddeyi, ilkeyi veya eki açmak

  • Bir alıntının kayıtlı metinde harfi harfine geçip geçmediğini doğrulatmak

  • Bülten rakamı, duyuru ve kısa dönem özeti istemek

Cevap, aracın döndürdüğü metne dayanmalıdır. Araç karar numarası, tarih veya sonuç uydurmaz; model de uydurmamalıdır.

Related MCP server: DAP Bellwether

Ne karar vermez?

  • Hukuki görüş veya olay bazında uygulanacak madde kararı vermez. Bir hükmün bugün yürürlükte olup olmadığını söylemez; bunu resmî kaynaktan doğrulamak gerekir.

  • Teknik doğrulama veya yeşil test, hukuki onay ya da banka kabulü değildir.

  • Her belgenin kaynakta hâlâ güncel olduğu ölçülmüş değildir. Kapsam, BDDK'nın tamamı değildir.

  • SPK metinleri bu sürümde yoktur.

  • Bazı belgelerde formül veya OCR uyarısı vardır. Uyarı varsa metni temiz saymayın. Ayrıntı: docs/DOCUMENT_QUALITY.md.

Düzenleme ve karar metinleri yerel yayımlanmış kopyadan gelir. Kurum, duyuru ve bülten araçları, özetin duyuru ve bülten yarısı dahil, BDDK'ya canlı gidebilir.

Araçlar

  • search_bddk_regulations: bu corpus'un kataloğunda başlık ve künye arar (BDDK sitesinde aramaz); anahtar kelime boş bırakılıp kategori (BDDK sitesindeki bölüm) veya tarih aralığıyla da listelenebilir. Türkçe harfli, harfsiz ve büyük harfli yazımı bulur; tam kelime ya da çekim eşleştirir. Madde metnini açmaz.

  • search_document_store: yayımlanmış metnin içinde arar; istenen sayıya kadar sonuç verir (güçlü ve orta sonuçlar, sonra sorgudaki tüm kelimeleri içeren anahtar kelime eşleşmeleri, sonra zayıf sonuçlar) ve aranan metin yazılandan farklıysa "Searched as" ile söyler.

  • search_bddk_institutions: kurum arar; canlı BDDK çağrısı yapabilir.

  • search_bddk_announcements: duyuru arar, en yeni 20'sini gösterir; canlı BDDK çağrısı yapabilir.

  • get_bddk_document: kayıtlı belge sayfasını getirir. Güvensiz çıkarım artığı varsa metni sessizce düzeltmez, reddeder.

  • get_document_history: bu corpus dosyasının yerel metin değişikliği kaydıdır, değişiklik (tadil) tarihçesi değildir. Yerine yenisi konmuş eski gövdeleri UTC zamanıyla listeler, mevcut gövdeyi ayrı bildirir; bir sync ya da build metni değiştirene kadar liste boştur. Kayıtlı olmayan belge numarası NOT_FOUND verir.

  • get_document_section: madde (66/A gibi araya eklenen maddeler dahil), geçici madde, ek madde, ilke, paragraf, ek veya bent ister; quotation verilirse alıntıyı kayıtlı metinde harfi harfine doğrular. İsteğe bağlı start_char aynı numaralı bölümlerden birini başlangıç konumuyla seçer (yalnızca bu corpus dosyası için geçerlidir, atıf değildir). Kayıtta kısaltılmış bir hüküm gerçek uzunluğuyla bildirilir; kayıtlı pencerenin dışında kalan ya da ardışık metin pencerelerinin birinde bulunmayan alıntı unavailable (doğrulanamadı) döner. Kayıtlı olmayan eklerin bu corpus'ta saklanmadığı söylenir.

  • search_document_sections: bölüm başlığında ve gövdesinde arar; madde yapısı olmayan belgeleri (örneğin Kurul Kararları) tam metin pencereleriyle bulur; metin pencereleri varsayılan olarak aranır ve türüyle etiketlenir.

  • get_bddk_bulletin: haftalık bülten; kapsanan dönemi ve birimi yazar (BDDK yaklaşık 13 hafta verir); canlı çağrı yapabilir.

  • get_bddk_bulletin_snapshot: bir tarihli bülten görüntüsü; canlı çağrı yapabilir.

  • get_bddk_monthly: aylık bülten; sütunları BDDK'nın kendi başlıklarıyla yazar; canlı çağrı yapabilir.

  • analyze_bulletin_trends: bülten serisinin yönünü okur; canlı çağrı yapabilir.

  • get_regulatory_digest: son dönem karar, duyuru ve bülten özeti. Kararlar yerel corpus kataloğundan gelir; duyuru ve bülten yarısı canlı olabilir.

  • compare_bulletin_metrics: en çok 4 bülten metriğini yan yana karşılaştırır; canlı çağrı yapabilir.

Sunucu yalnızca okur: corpus dosyasını salt okunur açar. Corpus'u hazırlayan komutlar ayrıdır: bddk-mcp build, seed_data/ içindeki belgelerden section, chunk ve embedding'leriyle tek bir SQLite corpus dosyası üretir; bddk-mcp sync belgeleri kaynaktan indirip aynı dosyaya yazar. bddk-mcp info corpus dosyasını değiştirmeden tanımlar (sürüm, içerik özeti, sayılar, embedding modeli, kayıtlı sync hataları, derleme parmak izinin güncel olup olmadığı; dosya hazır değilse çıkış kodu 1). bddk-mcp check-updates canlı BDDK catalog'unu ve kaynakları corpus dosyasıyla salt okunur karşılaştırır (yeni, listelenmeyen ve kaynağı değişen belgeler); bddk-mcp sync --add ID yalnızca seçilen belgeleri catalog'a ekleyip sync eder. Eski bir corpus dosyasını güncellemek için bddk-mcp build yeterlidir. Ayrıntı: docs/DEPLOYMENT.md.

Asistanı bağlama

Bağlantıyı teknik ekip kurar. Depodaki .mcp.json, stdio kullanan istemciler için taşınabilir yerel örnektir. Sunucunun tek girdisi corpus dosyasıdır: bddk-mcp build ile üretilir; yeri varsayılan corpus/bddk.sqlite değilse BDDK_CORPUS_PATH ile gösterilir. Veritabanı servisi ve bağlantı şifresi yoktur.

Codex

Codex için ~/.codex/config.toml veya güvenilen kopyadaki .codex/config.toml içine, cwd yolunu kendi kopyanıza göre değiştirerek ekleyin:

[mcp_servers.bddk]
command = "uv"
args = ["run", "--frozen", "bddk-mcp"]
cwd = "/absolute/path/to/bddk-mcp"
env_vars = ["BDDK_CORPUS_PATH"]
startup_timeout_sec = 30
tool_timeout_sec = 60

Bu örnek yerel stdio içindir. HTTP, kimlik ve ağ sınırı dağıtım belgesindedir.

Teknik ekip için kısa kayıt

Paket numarası 5.0.1'dir. Bu numarayla yayımlanmış bir GitHub sürüm etiketi yoktur.

Araç listesi bddk_mcp/tools/registry.py dosyasındadır: 14 araç, tek yüzey. Çalıştırma örneği: uv run --frozen bddk-mcp serve. Python 3.12 veya 3.13 ve uv gerekir; corpus tek bir SQLite dosyası olduğu için veritabanı servisi gerekmez.

Kurulum sırası bddk-mcp build (seed_data/ → corpus/bddk.sqlite; seed_data/embeddings/ içindeki hazır vektörler sayesinde dizüstü bir CPU'da yaklaşık yarım dakika sürer; vektörü olmayan veya değişen belgeler yeniden gömülür, sıfırdan gömme yaklaşık 15 dakikadır), sonra serve; sync isteğe bağlıdır. Önceki PostgreSQL tabanı 2026-11-10'da bu tek dosyayla değiştirildi ve archive/postgres-2026-11-10 etiketinde duruyor. 2026-11-09'da kaldırılan imzalı yayın töreni, çoklu veritabanı kimliği, operatör iş kuyruğu, admin konsolu, telemetri ve hiç veri yolu olmayan hukuki durum araçları (resolve_regulation_status, get_amendment_chain, get_cross_references) Git geçmişinde (archive/pre-simplify-2026-11-09 etiketi) duruyor.

Lisans

aa62301 commit'inden (2 Ekim 2026) sonraki sürümler PolyForm Noncommercial 1.0.0 lisansıyla dağıtılır. Kişisel, araştırma, eğitim ve ticari olmayan kuruluş kullanımı serbesttir. Bankalar, finansal kuruluşlar, danışmanlık firmaları ve diğer şirketlerin iş amaçlı kullanımı dahil her türlü ticari kullanım, telif hakkı sahibinden ayrı ve yazılı lisans alınmadan yasaktır. Kesin koşullar LICENSE dosyasındadır.

Ticari lisans: GitHub üzerinden benimle iletişime geçin.

aa62301 commit'i dahil önceki sürümler MIT Lisansı ile yayımlanmıştır; bu izin yalnızca o sürümler için geçerlidir. BDDK, Resmî Gazete ve diğer üçüncü taraf metinlerin kendi kaynak ve yeniden kullanım koşulları olabilir; kod lisansı bu metinler üzerinde ek hak vermez. Sınır: lisans ve kaynak.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      An MCP server for accessing Turkish legislation (laws, regulations, decrees) via the Adalet Bakanligi API, providing search, full-text retrieval, and structured citations.
      5
      62 PyPI
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server that aggregates and serves regulatory changes from Canadian, US, UK, and EU financial regulators via read-only tools for search, recent changes, and coverage monitoring.
      MIT
    • A
      license
      B
      quality
      F
      maintenance
      A read-only MCP server that exposes Turkish open banking data (accounts, balances, transactions, cash flow, and cards) to AI agents via the ÖHVPS 2.0.0 standard.
      5
      1
      MIT