Skip to main content
Glama
finans-mcp
by tufankoc

🚀 Finans MCP Server — BIST & Türkiye Piyasaları Yapay Zekâ Analiz Sunucusu

License: MIT Python 3.10+ FastMCP 3.0 MCP Registry BIST 100 Uyumlu

Finans MCP, Claude Desktop, Antigravity, Cursor, Windsurf, Roo Code ve tüm LLM/MCP istemcileri için geliştirilmiş, Borsa İstanbul (BIST), BDDK Bankacılık Sektör Verileri, TEFAS Yatırım Fonları, TCMB EVDS Makro Göstergeleri, KAP Bildirimleri, Aracı Kurum Konsensüs Tahminleri, Monte Carlo Simülasyonu ve Markowitz Portföy Optimizasyonu sunan açık kaynaklı kurumsal finans zekâ sunucusudur.


🌟 Neden Finans MCP?

  • 📈 62 BIST Aracı Kurumunun Doğrulanmış Portal Bağlantıları: İş Yatırım, Garanti BBVA, Ak Yatırım, Yapı Kredi, Gedik, QNB Finans, Osmanlı Menkul, GCM, Ahlatcı ve daha fazlası.

  • 🏛️ BDDK Türk Bankacılık Sektör Rasyoları (bddkR Uyumlu): Bilanço, Kredi/Mevduat, Takipteki Alacak (NPL), SYR ve ROE rasyoları.

  • 🎯 Analist Konsensüsü & Sapma (Contrarian) Analizi: Hedef fiyat ortalamaları, medyanlar, AL/TUT/SAT dağılımı ve konsensüsten ayrışan aykırı analist görüşleri (Z-skor > |1.5|).

  • 🎲 Monte Carlo & Markowitz Portföy Optimizasyonu: Geometric Brownian Motion ile 2,500 patika simülasyonu, VaR/CVaR risk hesaplaması ve optimal Sharpe oranlı portföy ağırlıkları.

  • 🏛️ TCMB EVDS Makro & TEFAS Fon Analizi: Politika faizi, TÜFE/ÜFE enflasyonu, TCMB net rezervleri, döviz kurları ve TEFAS fon fiyatları/AUM verileri.

  • 🌩️ Makro Stres Testi & Karar Denetim Defteri (Verdict Matrisi): Portföyü BIST çöküşü (%-30), kur şoku (%+25) ve stagflasyonda simüle etme; geçmiş yatırım kararlarını Doğru/Yanlış Gerekçe × Sonuç matrisiyle denetleme.

  • ⚖️ 6362 Sayılı SPK Kanunu Uyumlu: Bilgi Suistimali (Md. 106), Piyasa Dolandırıcılığı (Md. 107) ve Tebliğ III-52.1 uyarınca entegre yasal mevzuat koruması.


Related MCP server: Trading MCP Server

⚡ Hızlı Kurulum Rehberi (3 Seçenek)

Seçenek 1: Sadece Prompt ile Kurulum (Yapay Zekâya Verin - En Kolay)

Yapay zekânıza (Claude, Antigravity, Cursor, Roo Code) aşağıdaki komutu verin:

"https://github.com/tufankoc/finans-mcp reposunu incele ve PROMPT_KURULUM.md dosyasındaki adımları izleyerek Finans MCP sunucusunu bilgisayarıma kur."

Seçenek 2: Tek Satır UVX / PIPX ile Çalıştırma (Sıfır Kurulum)

Sisteminize hiçbir şey kurmadan doğrudan çalıştırmak için MCP istemci konfigürasyonunuza (claude_desktop_config.json veya mcp_config.json) ekleyin:

{
  "mcpServers": {
    "finans-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/tufankoc/finans-mcp.git",
        "finans-mcp"
      ]
    }
  }
}

Seçenek 3: Terminalden 1-Komutla Kurulum (Yerel Kurulum)

git clone https://github.com/tufankoc/finans-mcp.git && cd finans-mcp && ./install.sh

🎯 Maksimum Verim Almak İçin İstem Rehberi (Master Prompt)

Finans MCP sunucusunun 19 aracını tam verimle çalıştırmak için yapay zekanıza (Claude, Antigravity, Cursor) şu istemi yapıştırabilirsiniz:

"Sen Borsa İstanbul (BIST), BDDK Bankacılık Sektörü, TEFAS Fonları ve Türkiye Makroekonomisi alanında uzmanlaşmış Kıdemli Kurumsal Yatırım Danışmanısın. Benim sorularımda openbb_hisse_analiz, konsensus_analiz, kap_son_bildirimler, monte_carlo_simulasyonu, markowitz_portfoy_optimizasyonu, stres_testi_simulasyonu, tcmb_evds_gostergeler, bddk_bankacilik_verileri araçlarını zincirleme çalıştır; Temel, Teknik, ICT/SMC, Wyckoff ve Karar Matrisi boyutlarıyla raporla."

Detaylı sorular ve kullanım rehberi için PROMPT_KULLANIM.md rehberini inceleyin.


🛠️ Sunucu Araçları (MCP Tools - 19 Araç)

Tool

İşlev

Örnek Yapay Zekâ İsteği

araci_kurum_listesi

Tüm 62 BIST üyesi aracı kurumun canlı doğrulanmış (200 OK) araştırma portal URL'lerini sunar.

"BIST aracı kurumlarının araştırma sitelerini listele."

rapor_indir

Belirtilen tarih ve kurum için rapor verilerini çeker ve Yıl/Ay/Gün klasörüne kaydeder.

"İş Yatırım'ın bugünkü raporlarını indir."

konsensus_analiz

Hisseler için ortalama hedef fiyat, medyan, AL/TUT/SAT dağılımı ve konsensüs skoru hesaplar.

"THYAO için aracı kurumların hedef fiyat konsensüsünü getir."

korelasyon_raporu

Aracı kurumlar arasındaki tahmin korelasyonunu (Pearson $r$) karşılaştırır.

"Garanti ile Ak Yatırım arasındaki tahmin korelasyonunu çıkar."

sapma_analizi_raporu

Konsensüsten belirgin şekilde ayrışan (Z-skor > |1.5|) kontrarian analist görüşlerini saptar.

"Piyasadan ayrışan aykırı analist tahminlerini raporla."

veri_durumu

Veri klasöründeki arşiv durumunu, toplam dosya ve tarih özetini raporlar.

"İndirilmiş rapor arşiv durumunu göster."

openbb_hisse_analiz

OpenBB & YFinance ile BIST ve küresel hisselerin temel rasyolarını (F/K, PD/DD, Temettü) getirir.

"GARAN ve EREGL temel rasyolarını karşılaştır."

openbb_makro_gostergeler

OpenBB entegrasyonu ile Dolar/TL, Euro/TL, BIST100, Altın, Petrol ve S&P500 makro verilerini sunar.

"Güncel kur, enflasyon ve BIST100 makro tablosunu çıkar."

monte_carlo_simulasyonu

Geometric Brownian Motion (Boyle 1977) ile 2,500 patika simüle ederek Ayı/Boğa senaryolarını ve VaR/CVaR hesaplar.

"THYAO hissesi için 250 günlük Monte Carlo simülasyonu yap."

markowitz_portfoy_optimizasyonu

Markowitz Modern Portföy Teorisi (1952) ile 10,000 portföy simüle eder ve optimal Sharpe oranlı ağırlıkları bulur.

"THYAO, GARAN, KCHOL, TUPRS için optimal Markowitz portföyünü hesapla."

kap_son_bildirimler

Kamuyu Aydınlatma Platformu (KAP) üzerinden şirket açıklamalarını (ÖDA, Bilanço, Temettü) orijinal URL'leri ile çeker.

"THYAO için son KAP açıklamalarını getir."

kap_insider_islemleri

KAP pay alım/satım bildirimlerini (yönetim kurulu üyeleri ve büyük ortak işlemleri) süzerek raporlar.

"Son insider pay alım satımlarını raporla."

spk_yasal_uyum_denetimi

6362 sayılı SPK Kanunu (Md. 106/107) ve Tebliğ III-52.1 uyarınca sistemin yasal koruma ve mevzuat denetimini sunar.

"SPK yasal uyum raporunu getir."

portfoy_risk_analizi

Portföyün Sharpe, Sortino, Max Drawdown, Alfa ve HHI Yoğunlaşma İndeksini hesaplar.

"Portföyümün Sharpe, Sortino ve HHI skorunu hesapla."

stres_testi_simulasyonu

Portföyü BIST çöküşü, kur şoku, faiz artışı ve stagflasyon kriz senaryolarında simüle eder.

"Portföyü BIST çöküşü kriz senaryosunda simüle et."

tcmb_evds_gostergeler

TCMB EVDS ve TÜİK verileri ile Politika Faizi, TÜFE/ÜFE, Rezervler ve Kur göstergelerini sunar.

"TCMB politika faizi ve net rezerv verilerini getir."

tefas_fon_analiz

TEFAS fon fiyatları, AUM (yönetilen varlık büyüklüğü), yatırımcı sayısı ve getirilerini raporlar.

"TI4 fonunun detaylarını ve yıllık getirisini göster."

karar_denetim_defteri

Geçmiş yatırım kararlarını Verdict Matrisi (Doğru/Yanlış Gerekçe × Sonuç) ile denetler ve kalibrasyon skoru üretir.

"Geçmiş yatırım kararlarımın Verdict Matrisi analizini yap."

bddk_bankacilik_verileri

BDDK Türk Bankacılık Sektörü Bilanço, Krediler, Takipteki Alacak Oranı (NPL), SYR ve ROE verilerini sunar.

"BDDK mevduat ve kamu bankacılığı sektörü rasyolarını getir."


🌐 MCP Registry & Ekosistem Kayıtları

Finans MCP aşağıdaki küresel MCP dizinlerinde yayınlanmıştır:

  • Smithery.ai: smithery.json entegrasyonu ile tek tıkla yükleme.

  • Glama.ai: glama.json entegrasyonu ile listelenmiştir.


⚖️ Yasal Uyarı (SPK Disclaimer)

Yasal Uyarı: Bu sunucu ve araçlar tarafından sağlanan veri, analiz ve raporlar yatırım danışmanlığı kapsamında değildir. Yatırım danışmanlığı hizmeti; aracı kurumlar, portföy yönetim şirketleri, mevduat kabul etmeyen bankalar ile müşteri arasında imzalanacak yatırım danışmanlığı sözleşmesi çerçevesinde sunulmaktadır. Burada yer alan görüş ve analizler genel niteliktedir ve sadece bilgilendirme amacı taşımaktadır.


📜 Lisans

Bu proje MIT Lisansı ile lisanslanmıştır. Özgürce kullanılabilir, geliştirilebilir ve dağıtılabilir.

Available Tools

18 tools
araci_kurum_listesiA

Sistemde kayıtlı tüm aracı kurumları ve araştırma portalı kaynaklarını listele.

Borsa İstanbul üye kodları, araştırma portalları (Portal 1 & Portal 2), hedef fiyat takip URL'leri ve Python kütüphane ipuçlarını döndürür.

Inputs: no named parameters. Returns: result

kap_insider_islemleriA

KAP üzerinden yönetim kurulu üyeleri ve büyük ortakların pay alım/satım (Insider) bildirimlerini listele.

Inputs: hisse_kodu. Returns: result

kap_son_bildirimlerA

Kamuyu Aydınlatma Platformu (KAP) üzerinden şirket açıklamalarını ve bildirimlerini çek.

Özel Durum Açıklamaları (ÖDA), Finansal Raporlar, Temettü ve Sermaye Artırımı bildirimlerini orijinal KAP URL'leri ile getirir.

Inputs: limit, hisse_kodu. Returns: result

karar_denetim_defteriB

Geçmiş yatırım kararlarını Verdict Matrisi (Doğru/Yanlış Gerekçe x Sonuc) ile denetle ve kalibrasyon skoru üret.

Inputs: islem_gecmisi_json. Returns: result

konsensus_analizA

Tüm aracı kurumların hedef fiyatlarını çapraz karşılaştır ve konsensüs skoru üret.

İndirilen raporlardaki hedef fiyatları sentezleyerek:

  • Ortalama / medyan / en yüksek / en düşük hedef fiyat

  • AL/TUT/SAT dağılımı

  • Konsensüs skoru (-1 ile +1 arası)

  • Standart sapma (analistler arası uyum derecesi)

Inputs: hisse_kodu. Returns: result

korelasyon_raporuA

Aracı kurumlar arasındaki hedef fiyat korelasyonunu hesapla.

Hangi kurumlar birbirine yakın tahminler yapıyor? Hangi kurum sürüden ayrışıyor? Pearson korelasyon katsayısı ve ortalama sapma yüzdesi ile raporlar.

Inputs: no named parameters. Returns: result

markowitz_portfoy_optimizasyonuA

Markowitz Modern Portföy Teorisi (1952) ile Etkin Sınır ve Maksimum Sharpe Portföyü hesapla.

Nobel Ödüllü Harry Markowitz (1952) yöntemini kullanarak 10,000 rastgele portföy simüle eder, Sharpe oranını maksimize eden optimal varlık dağılım ağırlıklarını çıkarır.

Inputs: hisseler_csv, getiriler_csv, volatiliteler_csv, risk_free_rate_pct. Returns: result

monte_carlo_simulasyonuA

Geometric Brownian Motion (GBM) ile Monte Carlo Fiyat Yolu Simülasyonu gerçekleştir.

Boyle (1977) ve Glasserman (2003) tarafından teorik ve pratikte kanıtlanmış GBM modelini kullanır. 2,500 rastgele fiyat patikası simüle ederek Ayı (%5 P5), Medyan (%50 P50) ve Boğa (%95 P95) senaryoları ile VaR (Value at Risk) ve CVaR risk metriklerini hesaplar.

Inputs: sembol, gun_sayisi, mevcut_fiyat, simulasyon_sayisi, +2 more. Returns: result

openbb_hisse_analizB

OpenBB ve yfinance entegrasyonu ile BIST ve küresel hisse temel analiz verilerini çek.

Fiyat/Kazanç (F/K), Piyasa Değeri / Defter Değeri (PD/DD), Temettü Verimi, 52 Haftalık aralık ve analist ortalama hedef fiyatlarını raporlar.

Inputs: sembol. Returns: result

openbb_makro_gostergelerA

OpenBB entegrasyonu ile USD/TRY, EUR/TRY, BIST100, Altın, Petrol ve S&P500 makro verilerini getir.

Inputs: no named parameters. Returns: result

portfoy_risk_analiziA

Portföyün Sharpe, Sortino, Max Drawdown risk metriklerini ve HHI yoğunlaşma skorunu hesapla.

Inputs: risk_free_rate_pct, hisseler_ve_agirliklar_csv. Returns: result

rapor_indirA

Aracı kurumdan güncel rapor indir ve tarih bazlı klasöre kaydet.

Dosyalar data/raporlar/{yıl}/{ay}/{gün}/{tarih}-{kurum}-{tip}.pdf yapısında saklanır.

Inputs: tarih, kurum_kodu, rapor_tipi. Returns: result

sapma_analizi_raporuA

Konsensüsten en çok sapan analist görüşlerini bul.

Z-skoru ile ölçerek hangi aracı kurum hangi hissede sürüden ayrışıyor belirler. Kontrarian fırsat tespiti için kullanılır.

Inputs: no named parameters. Returns: result

spk_yasal_uyum_denetimiA

Sistemin 6362 sayılı Sermaye Piyasası Kanunu ve SPK Tebliğlerine uyum durumunu denetle.

Yatırım Danışmanlığı lisans şartları (Tebliğ III-52.1), Bilgi Suistimali (Madde 106) ve Piyasa Dolandırıcılığı (Madde 107) açısından yasal koruma maddelerini raporlar.

Inputs: no named parameters. Returns: result

stres_testi_simulasyonuB

Portföyü BIST Çöküşü, Kur Şoku, Faiz Artışı ve Stagflasyon kriz senaryolarında simüle et.

Inputs: senaryo, hisseler_ve_agirliklar_csv. Returns: result

tcmb_evds_gostergelerA

TCMB EVDS ve TÜİK verileri ile Politika Faizi, TÜFE/ÜFE, Rezervler ve Kur göstergelerini raporla.

Inputs: no named parameters. Returns: result

tefas_fon_analizB

TEFAS (Türkiye Elektronik Fon Alım Satım Platformu) fon fiyatı, AUM büyüklüğü ve getiri analizi yap.

Inputs: fon_kodu. Returns: result

veri_durumuA

İndirilen raporların ve veri dizininin genel durumunu göster.

Hangi tarihlerde kaç rapor indirilmiş, dizin yapısının özeti.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 18 tools

    Disambiguation3/5

    Most tools have distinct targets, but several quantitative/analytical tools overlap: portfoy_risk_analizi, monte_carlo_simulasyonu, and stres_testi_simulasyonu all compute risk metrics (VaR, CVaR) and could be confused. Similarly, sapma_analizi_raporu and korelasyon_raporu both measure analyst divergence. The descriptions help, but the boundaries are slightly blurry.

    Naming Consistency3/5

    Tool names are mostly snake_case noun phrases (e.g., kap_son_bildirimler, portfoy_risk_analizi), but rapor_indir follows an object-verb pattern. Prefixes like kap_, spk_, tcmb_, tefas_, openbb_ are applied inconsistently, and no uniform verb_noun or noun_verb structure is maintained across the set.

    Tool Count4/5

    At 18 tools, the server is on the heavier side but still appropriate for a comprehensive finance domain covering regulatory data, analytics, simulations, and report management. Each tool fills a niche, though a few could potentially be consolidated.

    Completeness4/5

    The server covers a broad swath of Turkish financial research: KAP disclosures, insider transactions, regulatory compliance, portfolio analytics, macro data, fund analysis, broker consensus, and simulations. Minor gaps exist (e.g., no dedicated tool for financial statement parsing beyond KAP announcements), but the overall surface is robust and cohesive.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Control Protocol server that provides access to Turkey's Public Disclosure Platform (KAP) data, including company information, financial reports, market announcements, and sector information.
      2
      -
    • A
      license
      A
      quality
      D
      maintenance
      A comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.
      10
      75
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Comprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.
      26
      9 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for listing, comparing, and analyzing Turkish TEFAS mutual funds, including performance metrics and portfolio breakdowns.
      6
      MIT