# Currency Exchange MCP 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:**

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

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

```bash
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:

```json
{
  "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.