🏦 mcp-tcmb-exchange

TCMB (Türkiye Cumhuriyet Merkez Bankası) resmi günlük döviz kurlarını MCP (Model Context Protocol) üzerinden AI asistanlarına (Claude, Cursor, Gemini vb.) sunan güçlü ve güvenilir bir Python sunucusudur.

✨ Özellikler

• Gerçek Zamanlı Veri: TCMB'nin güncel döviz kurlarına anında erişim.
• Hassas Hesaplama: Tamamı Decimal kullanılarak geliştirilmiş, yuvarlama hatalarından arındırılmış finansal hesaplamalar.
• Geçmiş Tarih Desteği: İstenilen tarihteki (YYYY-MM-DD) kurları sorgulayabilme.
• Çoklu Çeviri: Tek bir tutarı aynı anda birden fazla döviz cinsine çevirebilme.
• Hızlı ve Asenkron: httpx ve asenkron mimari ile gecikmesiz haberleşme.
• Dahili Önbellekleme: Gereksiz ağ isteklerini önlemek için 30 dakikalık memory cache.

🛠️ MCP Araçları (Tools)

Bu sunucu, AI asistanlarına aşağıdaki araçları sağlar:

Not: Tüm araçlar opsiyonel olarak date (YYYY-MM-DD) parametresi alabilir. Belirtilmezse o günkü güncel kur kullanılır.

🚀 Çalıştırma Yöntemleri

Sunucuyu sisteminizde çalıştırmak için aşağıdaki yöntemlerden birini seçebilirsiniz (Python 3.10 veya üzeri gereklidir):

1. PyPI Üzerinden Pip Install Sonrası:

Eğer paketi global veya sanal ortama kurduysanız, terminalden direkt olarak komutu çağırabilirsiniz.

pip install mcp-tcmb-exchange

mcp_config.json dosyanıza şu şekilde ekleyebilirsiniz:

{
  "mcpServers": {
    "mcp-tcmb-exchange": {
      "command": "mcp-tcmb-exchange"
    }
  }
}

2. UVX ile (Sıfır Kurulum, Anında Çalıştırma):

Sisteminizde uv yüklüyse, hiçbir kurulum yapmadan izole bir ortamda sunucuyu anında başlatabilirsiniz.

mcp_config.json dosyanıza şu şekilde ekleyebilirsiniz:

{
  "mcpServers": {
    "mcp-tcmb-exchange": {
      "command": "uvx",
      "args": ["mcp-tcmb-exchange"]
    }
  }
}

3. GitHub Kaynak Kodundan Çalıştırma:

Projeyi klonlayıp kendi yerel ortamınızda geliştirmek veya çalıştırmak isterseniz:

git clone https://github.com/iamseyhmus7/mcp-tcmb-exchange.git
cd mcp-tcmb-exchange
pip install -e .

mcp_config.json dosyanıza şu şekilde ekleyebilirsiniz:

{
  "mcpServers": {
    "mcp-tcmb-exchange": {
      "command": "python",
      "args": ["-m", "mcp_tcmb_exchange"]
    }
  }
}

⚠️ Önemli Uyarılar ve Kısıtlamalar

• Güncelleme Saati: TCMB kurları iş günlerinde saat 15:30 civarında güncellenmektedir.
• Tatiller: Hafta sonu ve resmi tatillerde yeni kur yayınlanmaz, bir önceki iş gününün kuru geçerli olur.
• Yatırım Tavsiyesi Değildir: Bu araç sadece bilgilendirme amaçlıdır. Herhangi bir yatırım tavsiyesi içermez.
• Resmi Kaynak: Kesin ve resmi işlemler için tcmb.gov.tr adresini referans alınız.

📄 Lisans

Bu proje MIT lisansı altında açık kaynak olarak paylaşılmıştır.

👨‍💻 Geliştirici

• Şeyhmus OK