使用说明
🏦 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ı
Decimalkullanı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:
httpxve 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:
| Araç Adı | Açıklama | Zorunlu Parametreler |
|---|---|---|
get_exchange_rate |
Tek bir dövizin günlük TCMB kurunu getirir. | currency_code (Örn: USD, EUR) |
list_all_rates |
Tüm TCMB kurlarını detaylı olarak listeler. | Yok |
convert_currency |
TL↔Döviz veya Döviz↔Döviz arasında çeviri yapar. | amount, from_currency, to_currency |
convert_to_multiple |
Bir tutarı aynı anda birçok farklı dövize çevirir. | amount, target_currencies |
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.