Borsa MCP: Türk Finans Piyasaları için MCP Sunucusu

Borsa İstanbul (BIST) ve ABD (US) hisseleri, TEFAS fonları, kripto paralar ve döviz/emtia verilerine LLM'ler üzerinden erişim sağlayan FastMCP sunucusu. KAP, Yahoo Finance, BtcTurk, Coinbase, borsapy ve TCMB gibi kaynaklardan 26 birleşik araç ile kapsamlı finansal analiz.

⚠️ Önemli Uyarılar

• LLM'ler halüsinasyon yapabilir - Verileri mutlaka doğrulayın

• Yatırım tavsiyesi değildir - Profesyonel danışmanlık alın

• Eğitim amaçlıdır - Sorumluluk size aittir

🚀 5 Dakikada Başla (Remote MCP)

✅ Kurulum Gerektirmez! Hemen Kullan!

🔗 Remote MCP Adresi: https://borsamcp.fastmcp.app/mcp

Claude Desktop ile Kullanım (Ücretli abonelik gerekir)

1. Claude Desktop'ı açın

2. Settings → Connectors → Add Custom Connector

3. Bilgileri girin:

   • Name: Borsa MCP

   • URL: https://borsamcp.fastmcp.app/mcp

4. Add butonuna tıklayın

5. Hemen kullanmaya başlayın! 🎉

Google Antigravity ile Kullanım

1. Agent session açın ve editörün yan panelindeki "…" dropdown menüsüne tıklayın

2. MCP Servers seçeneğini seçin - MCP Store açılacak

3. Üstteki Manage MCP Servers butonuna tıklayın

4. View raw config seçeneğine tıklayın

5. mcp_config.json dosyasına aşağıdaki yapılandırmayı ekleyin:

💡 İpucu: Remote MCP sayesinde Python, uv veya herhangi bir kurulum yapmadan doğrudan Google Antigravity üzerinden Türk finans piyasalarına erişebilirsiniz!

Örnek Sorular:

🎯 Temel Özellikler

26 Birleşik Araç ile Kapsamlı Finansal Analiz (v0.9.0):

• 📈 Hisse Senetleri (BIST + US): 758 BIST + tüm NYSE/NASDAQ şirketleri, tek araçla market parametresi ile

• 🔍 Teknik Tarama: BIST teknik scanner (RSI, MACD, Supertrend, T3) + US screener (23 preset)

• 🆕 Makro Veriler: TCMB enflasyon verileri ve hesaplama araçları (get_macro_data)

• 🎯 Pivot Points: 3 direnç & 3 destek seviyesi hesaplama (klasik pivot formülü)

• 📊 Endeksler: BIST + US endeksleri tek araçla (get_index_data)

• 💡 Değer Yatırımı: Buffett analizi ve finansal sağlık araçları (ROE, ROIC, Altman Z-Score)

• 💰 TEFAS Fonları: 836+ fon, performans, portföy, karşılaştırma (compare_mode)

• ₿ Kripto Paralar: BtcTurk + Coinbase birleşik (get_crypto_market)

• 💱 Döviz & Emtia: 65 para birimi, altın, petrol (borsapy entegrasyonu)

• 📅 Ekonomik Takvim: TR, US, EU, DE, GB, JP, CN (7 ülke)

• ☪️ Katılım Finans: Katılım finans uygunluk bilgisi (include_islamic parametresi)

• 📰 KAP Haberleri: Liste + detay (news_id parametresi ile)

• 📋 Yardım Araçları: get_screener_help, get_scanner_help, get_regulations

• ⚡ LLM Optimizasyonu: İngilizce açıklamalar, domain-spesifik araç seçimi

• 🚀 FastMCP 2.14: Response Caching + Background Tasks

📑 İçindekiler

💻 Gelişmiş Kurulum (İsteğe Bağlı)

Not: Remote MCP kullanıyorsanız bu adımları atlayabilirsiniz!

5ire ve Diğer MCP İstemcileri için Local Kurulum

Bu bölüm, Borsa MCP'yi 5ire gibi diğer MCP istemcileriyle local olarak kullanmak isteyenler içindir.

• Python Kurulumu: Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "Add Python to PATH" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. Buradan indirebilirsiniz.

• Git Kurulumu (Windows): Bilgisayarınıza git yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.

• uv

  • Windows Kullanıcıları (PowerShell): Bir CMD ekranı açın ve bu kodu çalıştırın: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  • Mac/Linux Kullanıcıları (Terminal): Bir Terminal ekranı açın ve bu kodu çalıştırın: curl -LsSf https://astral.sh/uv/install.sh | sh

• Microsoft Visual C++ Redistributable (Windows): Bazı Python paketlerinin doğru çalışması için gereklidir. Buradan indirip kurun.

• İşletim sisteminize uygun 5ire MCP istemcisini indirip kurun.

• 5ire'ı açın. Workspace -> Providers menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.

• Tools menüsüne girin. +Local veya New yazan butona basın.

  • Tool Key: borsamcp

  • Name: Borsa MCP

  • Command:

    uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp

  • Save butonuna basarak kaydedin.

• Şimdi Tools altında Borsa MCP'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).

• Artık Borsa MCP ile konuşabilirsiniz.

Claude Desktop için Local Kurulum

Not: Remote MCP daha kolay bir seçenektir. Sadece local kurulum yapmak istiyorsanız bu adımları izleyin.

1. Ön Gereksinimler: Python, uv, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.

2. Claude Desktop Settings -> Developer -> Edit Config.

3. Açılan claude_desktop_config.json dosyasına mcpServers altına ekleyin. UYARI: // ile başlayan yorum satırını silmelisiniz:

   { "mcpServers": { // ... (varsa diğer sunucularınız) ... "Borsa MCP": { "command": "uvx", "args": [ "--from", "git+https://github.com/saidsurucu/borsa-mcp", "borsa-mcp" ] } } }

4. Claude Desktop'ı kapatıp yeniden başlatın.

🛠️ Kullanılabilir Araçlar (MCP Tools)

Bu FastMCP sunucusu LLM modelleri için 26 birleşik araç sunar. Tüm araçlar market parametresi ile BIST ve US piyasalarını destekler.

Hisse Senedi Araçları (15 araç - BIST + US)

Kripto Araçları (1 araç - BtcTurk + Coinbase)

FX & Makro Araçları (4 araç)

Fon & Endeks Araçları (2 araç)

Makro & Yardım Araçları (4 araç)

Eski Sunucu (Geriye Uyumluluk)

Legacy sunucu (81 araç) borsa-mcp-legacy komutu ile hala kullanılabilir.

🔍 Veri Kaynakları & Kapsam

KAP (Kamuyu Aydınlatma Platformu)

• Şirketler: 758 BIST şirketi (ticker kodları, adlar, şehirler, çoklu ticker desteği)

• Katılım Finans: Resmi katılım finans uygunluk değerlendirmeleri

• Güncelleme: Otomatik önbellek ve yenileme

Yahoo Finance Entegrasyonu

• Endeks Desteği: Tüm BIST endeksleri (XU100, XBANK, XK100 vb.) için tam destek

• Zaman Dilimi: Tüm zaman damgaları Avrupa/İstanbul'a çevrilir

• Veri Kalitesi: Büyük bankalar ve teknoloji şirketleri en iyi kapsama sahiptir

• Tarih Aralığı Desteği: Belirli tarihler arası sorgulama (YYYY-MM-DD formatında, örn: "2024-01-01" - "2024-12-31")

• İki Sorgu Modu:

  • Dönem Modu: Period parametresi ile (1d, 1mo, 1y, vb.) - varsayılan

  • Tarih Modu: start_date ve end_date parametreleri ile belirli tarih aralığı

US Stock Market (Yahoo Finance)

• Kapsam: S&P 500, Nasdaq-100, Dow Jones ve NYSE'deki tüm şirketler

• Endeksler: 28 ana US endeksi (^GSPC, ^IXIC, ^DJI, Russell, sektör ETF'leri)

• Kategoriler: Large Cap, Tech, Blue Chip, Small Cap, Mid Cap, International

• Finansal Tablolar: Quarterly ve annual balance sheet, income statement, cash flow

• Değer Analizi: Buffett analizi için US 10Y Treasury (^TNX) ve Fed %2.5 enflasyon hedefi

• Güncelleme: Gerçek zamanlı piyasa verileri

US Stock Screener (yfscreen paketi)

• Varlık Türleri: Hisse senedi (equity), ETF ve yatırım fonları (mutual funds)

• Preset Sayısı: 23 hazır tarama şablonu (18 hisse + 3 ETF + 2 yatırım fonu)

• Filtre Alanları: 96+ hisse senedi, 29 ETF, 28 yatırım fonu filtre alanı

• Operatörler: eq (eşit), gt (büyük), lt (küçük), btwn (arasında)

• Özel Filtreler: Kullanıcı tanımlı filtreler ile gelişmiş tarama

• Akıllı Alan Dönüşümü: ETF/fund taramalarında equity alanları otomatik dönüştürülür

• Otomatik Region: Custom filter kullanırken region=us otomatik eklenir

• Sayfalama: Offset/limit ile büyük sonuç setlerinde navigasyon

• Performans: Yahoo Finance screener API entegrasyonu, hızlı sonuçlar

BIST Hisse Tarayıcı (borsapy paketi)

• Veri Kaynağı: İş Yatırım gelişmiş hisse arama (borsapy kütüphanesi)

• Preset Sayısı: 15 hazır tarama şablonu (piyasa değeri, değer, temettü, momentum, hacim, yabancı, analist)

• Filtre Kriteri: 50+ filtre (13 kategori: değerleme, kârlılık, temettü, getiri, piyasa, yabancı, analist, endeks)

• Operatörler: min (minimum), max (maximum) ile aralık filtreleme

• Özel Filtreler: Kullanıcı tanımlı filtreler ile gelişmiş tarama

• Otomatik Birim Dönüşümü: Piyasa değeri ve hacim için TL → milyon TL otomatik dönüşüm

• Sayfalama: Offset/limit ile büyük sonuç setlerinde navigasyon

• Performans: İş Yatırım API entegrasyonu, hızlı sonuçlar

• Güncelleme: Gerçek zamanlı BIST verileri

Mynet Finans (Hibrit Mod)

• Türk Özel Verileri: Kurumsal yönetim, ortaklık yapısı, bağlı şirketler

• KAP Haberleri: Gerçek zamanlı resmi duyuru akışı

• Endeks Kompozisyonu: Canlı endeks şirket listeleri

TEFAS (Türkiye Elektronik Fon Alım Satım Platformu)

• Fon Evreni: 800+ Türk yatırım fonu

• Resmi API: TEFAS BindHistoryInfo ve BindHistoryAllocation API'leri

• Kategori Filtreleme: 13 fon kategorisi (borçlanma, hisse senedi, altın vb.)

• Performans Metrikleri: 7 dönemlik getiri analizi (1 günlük - 3 yıllık)

• Portföy Analizi: 50+ Türk varlık kategorisi ile detaylı dağılım

• Güncellik: Gerçek zamanlı fon fiyatları ve performans verileri

Fon Mevzuatı

• Kaynak: fon_mevzuat_kisa.md - 80,820 karakter düzenleme metni

• Kapsam: Yatırım fonları için kapsamlı Türk mevzuatı

• İçerik: Portföy limitleri, fon türleri, uyumluluk kuralları

• Güncelleme: Dosya metadata ile son güncelleme tarihi

BtcTurk Kripto Para Borsası (Türk Piyasası)

• İşlem Çiftleri: 295+ kripto para işlem çifti (ana TRY ve USDT piyasaları dahil)

• Para Birimleri: 158+ desteklenen kripto para ve fiat para birimi (BTC, ETH, TRY, USDT vb.)

• API Endpoint: Resmi BtcTurk Public API v2 (https://api.btcturk.com/api/v2)

• Piyasa Verileri: Gerçek zamanlı ticker fiyatları, emir defterleri, işlem geçmişi, OHLC/Kline grafikleri

• Türk Odak: TRY çiftleri için optimize edilmiş (BTCTRY, ETHTRY, ADATRY vb.)

• Güncelleme Sıklığı: Borsa bilgileri için 1 dakika önbellek ile gerçek zamanlı piyasa verileri

• Veri Kalitesi: Milisaniye hassasiyetli zaman damgaları ile profesyonel seviye borsa verileri

Coinbase Global Kripto Para Borsası (Uluslararası Piyasalar)

• İşlem Çiftleri: 500+ global kripto para işlem çifti (ana USD, EUR ve GBP piyasaları dahil)

• Para Birimleri: 200+ desteklenen kripto para ve fiat para birimi (BTC, ETH, USD, EUR, GBP vb.)

• API Endpoint: Resmi Coinbase Advanced Trade API v3 ve App API v2 (https://api.coinbase.com)

• Piyasa Verileri: Gerçek zamanlı ticker fiyatları, emir defterleri, işlem geçmişi, OHLC/mum grafikleri, sunucu zamanı

• Global Odak: Uluslararası piyasalar için USD/EUR çiftleri (BTC-USD, ETH-EUR vb.)

• Güncelleme Sıklığı: Borsa bilgileri için 5 dakika önbellek ile gerçek zamanlı piyasa verileri

• Veri Kalitesi: Coinbase (NASDAQ: COIN) kurumsal seviye global likidite ile işletme düzeyinde borsa verileri

• Kapsam: Tam global piyasa kapsama, kurumsal seviye işlem verileri, çapraz piyasa arbitraj fırsatları

• Çapraz Piyasa Analizi: Türk kripto piyasaları (BtcTurk TRY çiftleri) ile global piyasaları (Coinbase USD/EUR çiftleri) karşılaştırma

Dovizcom Döviz & Emtia Platformu (Türk & Uluslararası Piyasalar)

• Varlık Kapsamı: 28+ varlık (ana para birimleri, kıymetli madenler, enerji emtiaları, yakıt fiyatları)

• Ana Para Birimleri: USD, EUR, GBP, JPY, CHF, CAD, AUD ile gerçek zamanlı TRY döviz kurları

• Kıymetli Madenler: Hem Türk (gram-altın, gümüş) hem uluslararası (ons, XAG-USD, XPT-USD, XPD-USD) çifte fiyatlandırma

• Enerji Emtiaları: BRENT ve WTI petrol fiyatları ile tarihsel trendler ve piyasa analizi

• Yakıt Fiyatları: Dizel, benzin ve LPG fiyatları (TRY bazlı) ile günlük fiyat takibi

• API Endpoint: Resmi doviz.com API v12 (https://api.doviz.com/api/v12)

• Gerçek Zamanlı Veri: Kısa vadeli analiz için 60 veri noktasına kadar dakikalık güncellemeler

• Tarihsel Veri: Teknik analiz ve trend araştırması için özel tarih aralıklarında günlük OHLC verileri

• Güncelleme Sıklığı: Güncel kurlar için 1 dakika önbellek ile gerçek zamanlı piyasa verileri

• Veri Kalitesi: Türkiye'nin önde gelen finansal bilgi sağlayıcısından profesyonel seviye finansal veriler

• Piyasa Odağı: Çapraz piyasa analizi için uluslararası USD/EUR karşılaştırmaları ile Türk TRY bazlı fiyatlandırma

• Kimlik Doğrulama: Güvenilir API erişimi için uygun başlık yönetimi ile Bearer token kimlik doğrulaması

• Kapsam: Döviz ticareti, kıymetli maden yatırımı, emtia analizi ve yakıt fiyat takibi için tam finansal piyasalar kapsamı

Dovizcom Ekonomik Takvim (Çoklu Ülke Desteği)

• Makroekonomik Olaylar: GDP, enflasyon, istihdam, sanayi üretimi, PMI, işsizlik oranları ve diğer piyasa etkili ekonomik göstergeler

• Ülke Kapsamı: 30+ ülke (TR, US, EU, GB, JP, DE, FR, CA, AU, CN, KR, BR vb.) için ekonomik veri takibi

• Çoklu Ülke Filtreleme: Virgülle ayrılmış ülke kodları ile esnek filtreleme (örn: "TR,US,DE")

• Varsayılan Davranış: Türkiye ve ABD ekonomik olayları (TR,US) varsayılan olarak gösterilir

• API Endpoint: Resmi Doviz.com Economic Calendar API (https://www.doviz.com/calendar/getCalendarEvents)

• Filtreleme Özellikleri: Ülke bazlı filtreleme, önem seviyesi seçimi (yüksek/orta/düşük), özelleştirilebilir tarih aralıkları

• Veri Detayları: Gerçek değerler, önceki dönem verileri, tahminler (mevcut olduğunda), dönem bilgileri Türkçe açıklamalar

• Güncelleme Sıklığı: Gerçek zamanlı ekonomik olay takibi ve uluslararası piyasa etkisi analizi

• Zaman Dilimi Desteği: Avrupa/İstanbul ana zaman dilimi ile Türk saati koordinasyonu

• Veri Kalitesi: Doviz.com'un özelleşmiş finansal veri ağından profesyonel seviye uluslararası makroekonomik bilgiler

TCMB Enflasyon Verileri (Resmi Merkez Bankası)

• Veri Kaynağı: Türkiye Cumhuriyet Merkez Bankası resmi enflasyon istatistikleri sayfaları

• Veri Türleri:

  • TÜFE: Tüketici Fiyat Endeksi (2005-2025, 245+ aylık kayıt)

  • ÜFE: Üretici Fiyat Endeksi - Yurt İçi (2014-2025, 137+ aylık kayıt)

• Güncelleme Sıklığı: Aylık (genellikle ayın ortasında resmi açıklama)

• Veri Kalitesi: Resmi TCMB kaynağından web scraping ile %100 güvenilir

• Performans: 2-3 saniye (1 saatlik cache ile optimize edilmiş)

• Filtreleme: Enflasyon türü seçimi, tarih aralığı (YYYY-MM-DD), kayıt sayısı limiti

• İstatistikler: Min/max oranlar, ortalamalar, son değerler otomatik hesaplama

• Son Veriler (Mayıs 2025):

  • TÜFE: %35.41 (yıllık), %1.53 (aylık)

  • ÜFE: %23.13 (yıllık), %2.48 (aylık)

• Ekonomik Analiz: ÜFE öncü gösterge olarak TÜFE hareketlerini öngörmede kullanılır

📊 Örnek Kullanım

📜 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.