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

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: market-data-mcp

⚡ 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ç)

🌐 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.