Provides programmatic access to Borsa Istanbul (BIST) stock data, financials, news, and analysis using KAP and Yahoo Finance.
Bu proje, Borsa İstanbul (BIST) verilerine, Türk yatırım fonları verilerine, global kripto para verilerine ve döviz/emtia verilerine erişimi kolaylaştıran bir FastMCP sunucusu oluşturur. Bu sayede, KAP (Kamuyu Aydınlatma Platformu), TEFAS (Türkiye Elektronik Fon Alım Satım Platformu), BtcTurk, Coinbase, Doviz.com, Mynet Finans ve Yahoo Finance'dan hisse senedi bilgileri, fon verileri, hem Türk hem de global kripto para piyasa verileri, döviz kurları ve emtia fiyatları, 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.
⚠️ ÖNEMLİ UYARI
Borsa MCP, sadece açık kaynaklardan derlediği verileri büyük dil modellerine (LLM) ileten bir sistemdir. Alacağınız cevaplar kullandığınız LLM'in kabiliyetine göre değişir.
LLM'ler yeni bir teknolojidir ve bazen yanlış veya var olmayan bilgiler üretebilirler (halüsinasyon). Her zaman verilen bilgileri doğrulayın ve kritik kararlar için birden fazla kaynak kullanın.
Borsa MCP size HİÇBİR YATIRIM TAVSİYESİ VERMEZ. Sadece finansal verileri derler ve sunar. Yatırım kararlarınızı vermeden önce mutlaka lisanslı finansal danışmanlardan profesyonel destek alın.
Bu araç eğitim ve araştırma amaçlıdır. Finansal işlemleriniz için sorumluluk tamamen size aittir.
🎯 Temel Özellikler
Bu bölüm, Borsa MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle kullanmak isteyenler içindir.
uv
Kurulumu:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
curl -LsSf https://astral.sh/uv/install.sh | sh
borsamcp
Borsa MCP
uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp
Ö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.
Claude Desktop Settings -> Developer -> Edit Config.
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"
]
}
}
}
Claude Desktop'ı kapatıp yeniden başlatın.
Bu FastMCP sunucusu LLM modelleri için aşağıdaki araçları sunar:
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).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ı.get_kap_haberleri
: Son KAP haberleri ve resmi şirket duyuruları.get_kap_haber_detayi
: Detaylı KAP haber içeriği (Markdown formatında).get_endeks_kodu
: Güncel BIST endeks listesinde endeks kodu arama.get_endeks_sirketleri
: Belirli endeksteki şirketlerin listesi.get_katilim_finans_uygunluk
: KAP Katılım finans uygunluk verileri ve katılım endeksi üyeliği.search_funds
: Türk yatırım fonları arama (kategori filtreleme ve performans metrikleri ile).get_fund_detail
: Kapsamlı fon bilgileri ve analitiği.get_fund_performance
: Resmi TEFAS BindHistoryInfo API ile geçmiş fon performansı.get_fund_portfolio
: Resmi TEFAS BindHistoryAllocation API ile fon portföy dağılımı.compare_funds
: Resmi TEFAS karşılaştırma API ile çoklu fon karşılaştırması.get_fon_mevzuati
: Türk yatırım fonları mevzuat rehberi (hukuki uyumluluk için).get_kripto_exchange_info
: Tüm kripto çiftleri, para birimleri ve borsa operasyonel durumu.get_kripto_ticker
: Kripto çiftler için gerçek zamanlı fiyat verileri (çift veya kote para birimi filtresi ile).get_kripto_orderbook
: Güncel alış/satış emirlerini içeren emir defteri derinliği.get_kripto_trades
: Piyasa analizi için son işlem geçmişi.get_kripto_ohlc
: Kripto grafikleri ve teknik analiz için OHLC verileri.get_kripto_kline
: Çoklu zaman çözünürlükleri ile Kline (mum grafik) verileri.get_kripto_teknik_analiz
: Türk kripto piyasaları için RSI, MACD, Bollinger Bantları ve al-sat sinyalleri ile kapsamlı teknik analiz.get_coinbase_exchange_info
: Global işlem çiftleri ve para birimleri (USD/EUR piyasaları ile).get_coinbase_ticker
: Uluslararası piyasalar için gerçek zamanlı global kripto fiyatları (USD/EUR).get_coinbase_orderbook
: USD/EUR alış/satış fiyatları ile global emir defteri derinliği.get_coinbase_trades
: Çapraz piyasa analizi için son global işlem geçmişi.get_coinbase_ohlc
: USD/EUR kripto grafikleri için global OHLC verileri.get_coinbase_server_time
: Coinbase sunucu zamanı ve API durumu.get_coinbase_teknik_analiz
: Global kripto piyasaları için RSI, MACD, Bollinger Bantları ve al-sat sinyalleri ile kapsamlı teknik analiz.get_dovizcom_guncel
: Güncel döviz kurları ve emtia fiyatları (USD, EUR, GBP, gram-altın, ons, BRENT, dizel, benzin, LPG).get_dovizcom_dakikalik
: Gerçek zamanlı izleme için dakikalık veriler (60 veri noktasına kadar).get_dovizcom_arsiv
: Teknik analiz ve trend araştırması için tarihsel OHLC verileri.get_economic_calendar
: Çoklu ülke ekonomik takvimi (TR,US varsayılan) - GDP, enflasyon, istihdam verileri ve makroekonomik olaylar.get_turkiye_enflasyon
: Resmi TCMB TÜFE/ÜFE enflasyon verileri - TÜFE: tüketici fiyatları (2005-2025, 245+ kayıt), ÜFE: üretici fiyatları (2014-2025, 137+ kayıt) - yıllık/aylık oranlar, tarih aralığı filtreleme, istatistiksel özet.get_enflasyon_hesapla
: TCMB resmi enflasyon hesaplama API'si - iki tarih arası kümülatif enflasyon hesaplama, sepet değeri analizi, satın alma gücü kaybı/kazancı, ortalama yıllık enflasyon, TÜFE endeks değerleri.fon_mevzuat_kisa.md
- 80,820 karakter düzenleme metni# Ş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
# Fon arama ve analizi
"altın" fonları ara ve en iyi performans gösteren 3 tanesini karşılaştır
# Fon portföy analizi
AAK fonunun son 6 aylık portföy dağılım değişimini analiz et
# Fon mevzuat sorguları
Yatırım fonlarında türev araç kullanım limitleri nelerdir?
# Türk kripto para analizi
Bitcoin'in TRY cinsinden son 1 aylık fiyat hareketlerini analiz et
# Türk kripto piyasa takibi
BtcTurk'te en çok işlem gören kripto çiftleri listele ve fiyat değişimlerini göster
# Türk kripto emir defteri analizi
BTCTRY çiftinin emir defterini görüntüle ve derinlik analizini yap
# Global kripto para analizi
Bitcoin'in USD cinsinden Coinbase'deki son 1 aylık fiyat hareketlerini analiz et
# Global kripto piyasa takibi
Coinbase'de en popüler USD/EUR kripto çiftlerini listele ve global piyasa trendlerini göster
# Global kripto emir defteri analizi
BTC-USD çiftinin Coinbase emir defterini görüntüle ve global likidite analizini yap
# Çapraz piyasa kripto analizi
Bitcoin fiyatını Türk (BTCTRY) ve global (BTC-USD) piyasalarda karşılaştır
# Arbitraj fırsatı analizi
ETH fiyatlarını BtcTurk (ETHUSDT) ve Coinbase (ETH-USD) arasında karşılaştırarak arbitraj fırsatlarını tespit et
# BtcTurk kripto teknik analiz
BTCTRY çiftinin günlük teknik analizini yap ve al-sat sinyallerini değerlendir
# Coinbase global kripto teknik analiz
BTC-USD çiftinin 4 saatlik teknik analizini yap ve RSI, MACD durumunu analiz et
# Çapraz piyasa teknik analiz karşılaştırması
Bitcoin'in hem Türk piyasasında (BTCTRY) hem global piyasada (BTC-USD) teknik analiz sinyallerini karşılaştır
# Global kripto teknik analiz
ETH-EUR çiftinin günlük Bollinger Bantları ve hareketli ortalama durumunu analiz et
# Döviz kuru analizi
USD/TRY kurunun güncel durumunu ve son 1 saatteki dakikalık hareketlerini analiz et
# Altın fiyat takibi
Gram altının TRY cinsinden güncel fiyatını al ve son 30 dakikadaki değişimini göster
# Uluslararası altın karşılaştırması
Türk gram altını ile uluslararası ons altın fiyatlarını karşılaştır
# Emtia fiyat analizi
Brent petrolün son 6 aylık OHLC verilerini al ve fiyat trendini analiz et
# Kıymetli maden portföy takibi
Altın, gümüş ve platinyum fiyatlarının güncel durumunu ve haftalık performansını karşılaştır
# Çapraz döviz analizi
EUR/TRY ve GBP/TRY kurlarının güncel durumunu karşılaştır ve arbitraj fırsatlarını değerlendir
# Yakıt fiyat takibi
Dizel, benzin ve LPG fiyatlarının güncel durumunu ve haftalık değişimlerini analiz et
# Yakıt fiyat karşılaştırması
Son 3 aylık dizel ve benzin fiyat trendlerini karşılaştır ve analiz et
# Haftalık ekonomik takvim (çoklu ülke)
Bu haftanın önemli ekonomik olaylarını TR,US,DE için listele ve piyasa etkilerini değerlendir
# Tek ülke ekonomik takip
Sadece Almanya'nın bu ayki ekonomik verilerini getir ve analiz et
# Çoklu ülke ekonomik karşılaştırma
TR,US,GB,FR,DE ülkelerinin bu haftaki tüm ekonomik verilerini karşılaştır
# Ekonomik veri analizi
Türkiye ve ABD'nin son çeyrek GDP büyüme verilerini karşılaştır ve trend analizini yap
# TCMB TÜFE enflasyon analizi
Son 2 yılın tüketici enflasyon verilerini getir ve trend analizini yap
# TCMB ÜFE enflasyon analizi
Üretici enflasyonunun son 1 yılını analiz et ve TÜFE ile karşılaştır
# Enflasyon dönemsel analizi
2022-2024 yüksek enflasyon dönemini hem TÜFE hem ÜFE açısından analiz et
# TÜFE vs ÜFE karşılaştırması
Son 12 aylık TÜFE ve ÜFE verilerini karşılaştır ve fiyat geçişkenliğini analiz et
# Güncel enflasyon durumu
Son 6 aylık hem tüketici hem üretici enflasyon verilerini al ve Merkez Bankası hedefleriyle karşılaştır
# TCMB enflasyon hesaplayıcı analizi
2020'deki 100 TL'nin bugünkü satın alma gücünü hesapla
# Yüksek enflasyon dönemi analizi
2021-2024 yüksek enflasyon döneminde 1000 TL'nin değişimini hesapla ve kümülatif enflasyon etkisini analiz et
# Uzun dönemli satın alma gücü analizi
2010'dan bugüne 5000 TL'lik maaşın satın alma gücündeki değişimi hesapla
# Kısa dönemli enflasyon hesaplaması
Son 6 aylık enflasyon etkisini hesapla ve yıllık bazda projeksiyon yap
# Ekonomik kriz dönemleri karşılaştırması
2001, 2008 ve 2018 ekonomik krizlerinin enflasyon etkilerini karşılaştır
# Kontrat endeksleme hesaplaması
Kira sözleşmelerinin enflasyon ayarlaması için gerekli artış oranını hesapla
📜 Lisans
Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için LICENSE
dosyasına bakınız.
Create, manage, and update applications on InstantDB, the modern Firebase.
Enables secure interaction with MySQL databases, allowing AI assistants to list tables, read data, and execute SQL queries through a controlled interface.
Interact with Google BigQuery databases using natural language queries and schema exploration.
Perform database actions on Amazon Redshift via its Data API.
A server for interacting with MongoDB databases and MongoDB Atlas.
Server implementation for Google BigQuery integration that enables direct BigQuery database access and querying capabilities
A modular server providing unified access to multiple astronomical datasets, including astroquery services and DESI data sources.
A server for full integration with Oracle Database. Requires Oracle Instant Client libraries.
A comprehensive movie database server supporting advanced search, CRUD operations, and image management via a PostgreSQL database.
Securely query and retrieve data from your ThoughtSpot instance.