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

📢 Sunucu Taşındı

Borsa MCP sunucusu artık https://borsa.surucu.dev/mcp adresinde.

Eski adresi (borsamcp.fastmcp.app) kullanıyorsanız, yapılandırmanızı yukarıdaki yeni adresle güncelleyin. Eski adres bir süre daha ayakta kalacak ancak yalnızca bu taşınma bilgisini döndürüyor, piyasa verisi sunmuyor.

Açık kaynak projelerime sponsor olduğu için @arctcloud — Arct Cloud'a teşekkürler. Diğer MCP sunucularımı da vakit buldukça taşıyacağım.

Siz de SAID35 koduyla %35 indirimli kullanabilirsiniz: https://arct.cloud/?ref=x-promo-4exe09

🚀 5 Dakikada Başla (Remote MCP)

✅ Kurulum Gerektirmez! Hemen Kullan!

🔗 Remote MCP Adresi: https://borsa.surucu.dev/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://borsa.surucu.dev/mcp

1. Add butonuna tıklayın
2. 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:

{
  "mcpServers": {
    "borsa-mcp": {
      "serverUrl": "https://borsa.surucu.dev/mcp",
      "headers": {
        "Content-Type": "application/json"
      }
    }
  }
}

💡 İ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:

GARAN hissesinin son 1 aylık performansını analiz et
XU100 endeksinin bugünkü durumunu göster
Bitcoin'in TRY fiyatını kontrol et

🎯 Temel Özellikler

28 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)
• 🆕 TCMB EVDS: 145 kategori, on binlerce makro seri — faiz, döviz, ödemeler dengesi, enflasyon (get_evds_data, ücretsiz API key)
• 🆕 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 Kurulumu:
• 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"
          ]
        }
      }
    }

1. 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)