🚀 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ı.

---

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