MCP ExplorerExplorer

Borsa Mcp

@saidsurucuon 10 days ago
83 MIT
FreeCommunity
AI Systems
MCP Server for Istanbul Stock Exchange Data

Overview

What is Borsa Mcp

borsa-mcp is an MCP Server designed to facilitate access to data from the Istanbul Stock Exchange (BIST). It provides a comprehensive interface for programmatic access to stock information, financial data, technical analysis, and sector comparisons.

Use cases

Use cases for borsa-mcp include developing trading algorithms, conducting financial analysis for investment decisions, integrating with financial applications for real-time data access, and providing insights for analysts and traders in the Turkish stock market.

How to use

To use borsa-mcp, ensure you have Python 3.11 or higher installed on your system. Follow the installation instructions provided in the README, including adding Python to your PATH. Once set up, you can access the data through supported LLM applications like Claude Desktop or other MCP clients such as 5ire.

Key features

Key features of borsa-mcp include: a comprehensive MCP interface for BIST data access, company search by ticker code and name, financial data including balance sheets and cash flow statements, technical analysis indicators like RSI and MACD, analyst data including recommendations and earnings calendars, support for KAP news, full index support for BIST indices, and hybrid data from Yahoo Finance and Mynet Finans.

Where to use

borsa-mcp can be used in financial analysis, stock trading, investment research, and any application requiring access to real-time and historical data from the Istanbul Stock Exchange.

Content

Borsa MCP: Borsa İstanbul (BIST) için MCP Sunucusu

Star History Chart

Bu proje, Borsa İstanbul (BIST) verilerine erişimi kolaylaştıran bir FastMCP sunucusu oluşturur. Bu sayede, KAP (Kamuyu Aydınlatma Platformu), Mynet Finans ve Yahoo Finance’dan hisse senedi bilgileri, finansal veriler, teknik analiz ve sektör karşılaştırmaları, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop veya 5ire) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.

ornek

🎯 Temel Özellikler

  • Borsa İstanbul (BIST) verilerine programatik erişim için kapsamlı bir MCP arayüzü.
  • Aşağıdaki yetenekler:
    • Şirket Arama: 793 BIST şirketi arasında ticker kodu ve şirket adına göre arama.
    • Finansal Veriler: Bilanço, kar-zarar, nakit akışı tabloları ve geçmiş OHLCV verileri.
    • Teknik Analiz: RSI, MACD, Bollinger Bantları gibi teknik göstergeler ve al-sat sinyalleri.
    • Analist Verileri: Analist tavsiyeleri, fiyat hedefleri ve kazanç takvimi.
    • KAP Haberleri: Resmi şirket duyuruları ve düzenleyici başvurular.
    • Endeks Desteği: BIST endeksleri (XU100, XBANK, XK100 vb.) için tam destek.
    • Katılım Finans: Katılım finans uygunluk verileri.
    • Hibrit Veri: Yahoo Finance + Mynet Finans’tan birleştirilmiş şirket bilgileri.
  • Türk hisse senetleri ve endeksler için optimize edilmiş veri işleme.
  • Claude Desktop uygulaması ile kolay entegrasyon.
  • Borsa MCP, 5ire gibi Claude Desktop haricindeki MCP istemcilerini de destekler.

🚀 Claude Haricindeki Modellerle Kullanmak İçin Çok Kolay Kurulum (Örnek: 5ire için)

Bu bölüm, Borsa MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle 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 Manuel Kurulumu

  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:

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

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

Bu FastMCP sunucusu LLM modelleri için aşağıdaki araçları sunar:

Temel Şirket & Finansal Veriler

  • find_ticker_code: Güncel BIST şirketleri arasında ticker kodu arama.
  • get_sirket_profili: Detaylı şirket profili.
  • get_bilanco: Bilanço verileri (yıllık/çeyreklik).
  • get_kar_zarar_tablosu: Kar-zarar tablosu (yıllık/çeyreklik).
  • get_nakit_akisi_tablosu: Nakit akışı tablosu (yıllık/çeyreklik).
  • get_finansal_veri: Geçmiş OHLCV verileri (hisse senetleri ve endeksler için).

Gelişmiş Analiz Araçları

  • get_analist_tahminleri: Analist tavsiyeleri, fiyat hedefleri ve trendler.
  • get_temettu_ve_aksiyonlar: Temettü geçmişi ve kurumsal işlemler.
  • get_hizli_bilgi: Hızlı finansal metrikler (P/E, P/B, ROE vb.).
  • get_kazanc_takvimi: Kazanç takvimi ve büyüme verileri.
  • get_teknik_analiz: Kapsamlı teknik analiz ve göstergeler.
  • get_sektor_karsilastirmasi: Sektör analizi ve karşılaştırması.

KAP & Haberler

  • get_kap_haberleri: Son KAP haberleri ve resmi şirket duyuruları.
  • get_kap_haber_detayi: Detaylı KAP haber içeriği (Markdown formatında).

BIST Endeks Araçları

  • get_endeks_kodu: Güncel BIST endeks listesinde endeks kodu arama.
  • get_endeks_sirketleri: Belirli endeksteki şirketlerin listesi.

Katılım Finans

  • get_katilim_finans_uygunluk: KAP Katılım finans uygunluk verileri ve katılım endeksi üyeliği.

🔍 Veri Kaynakları & Kapsam

KAP (Kamuyu Aydınlatma Platformu)

  • Şirketler: 793 BIST şirketi (ticker kodları, adlar, şehirler)
  • 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

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

📊 Örnek Kullanım

# Şirket arama
GARAN hissesi için detaylı analiz yap

# Endeks analizi  
XU100 endeksinin son 1 aylık performansını analiz et

# Teknik analiz
ASELS için kapsamlı teknik analiz ve al-sat sinyalleri ver

# KAP haberleri
THYAO için son 5 KAP haberini getir ve ilkinin detayını analiz et

# Katılım finans
ARCLK'nın katılım finans uygunluğunu kontrol et

# Sektör karşılaştırması
Bankacılık sektöründeki ana oyuncuları karşılaştır: GARAN, AKBNK, YKBNK

📜 Lisans

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

Tools

No tools

Comments