Currency Exchange Server

---

🛠️ Özellikler

• 🔄 Gerçek zamanlı döviz kuru sorgulama
• 🤖 AI model entegrasyonu
• 🛠️ MCP protokolü desteği
• ⚡ Modern uv dependency management
• 💱 ExchangeRate API entegrasyonu

Kurulum & Çalıştırma

1. Depoyu klonlayın:

git clone https://github.com/kullanıcı/MCP-Exchange.git
cd MCP-Exchange

2. Bağımlılıkları yükleyin:

uv venv
source .venv/bin/activate  # macOS/Linux
# veya
.venv\Scripts\activate     # Windows
uv pip install .

3. ExchangeRate API Anahtarınızı ayarlayın:

.env dosyasında EXCHANGE_API_KEY tanımlayın (API anahtarı ve belgelendirme için exchangerate-api.com sitesini kontrol edebilirsiniz).

EXCHANGE_API_KEY=YOUR_API_KEY

4. Sunucuyu çalıştırın:

Claude Desktop yapılandırma dosyasına (claude_desktop_config.json) manuel olarak ekleyin:

{
  "mcpServers": {
    "Exchange": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli],requests,python-dotenv",
        "mcp",
        "run",
        "/tam/yol/MCP-Exchange/main.py"
      ]
    }
  }
}

💻 Claude Desktop ile Çalıştırma

1. Claude Desktop uygulaması açılır. "Exchange" seçeneği File > Settings > Developer sekmesinde ve sohbet ekranındaki ayarlarda görünmelidir.

2. Sohbet bölümünde "Exchange"e tıkladığımızda, main.py'de tanımlanan get_exchange_rate aracı aktif olarak listelenir.

3. "Londra'da döviz kuru nedir?" sorusu sorulduğunda get_exchange_rate işlemi başlar.

4. Doğrulamadan sonra, get_exchange_rate parametreleri ve dönüş sonucu ile yanıt döner.

---

📋 API Araçları

• get_exchange_rate(base, target): İki para birimi arasındaki gerçek zamanlı döviz kuru bilgisi

💡 Örnek Kullanım

Kullanıcı: "USD TRY kuru nedir?"
AI: get_exchange_rate fonksiyonu otomatik tetiklenir
Sonuç: {"rate": 40.28, "base": "USD", "target": "TRY", "last_updated": "..."}

---

🔧 Geliştirme

• Python 3.13+
• MCP Protocol
• ExchangeRate API
• Modern uv package manager

📄 Lisans

MIT License

---

Not: Normal döviz kuru uygulamalarından farklı olarak, kullanıcının manuel olarak döviz kuru bilgisini sorguladığı uygulamalardan farklı olarak, MCP-Exchange protokol tabanlı bir araç olarak çalışır. Döviz kuru verilerini JSON'da standartlaştırır ve MCP çerçevesi içinde çalışır. Claude Desktop gibi AI modelleri, kullanıcının sorusuna dayalı olarak manuel müdahale olmaksızın otomatik olarak tetikler. Bu da onu bağımsız bir döviz kuru uygulamasından ziyade sorunsuz entegre edilmiş bir backend hizmeti haline getirir.