内容
# 货币兑换 MCP 服务器
---
## 🛠️ 特性
- 🔄 实时汇率查询
- 🤖 AI 模型集成
- 🛠️ MCP 协议支持
- ⚡ 现代 uv 依赖管理
- 💱 ExchangeRate API 集成
## 安装 & 运行
1. **克隆仓库：**
```bash
git clone https://github.com/用户/MCP-Exchange.git
cd MCP-Exchange
```
2. **安装依赖：**
```bash
uv venv
source .venv/bin/activate # macOS/Linux
# 或
.venv\Scripts\activate # Windows
uv pip install .
```
3. **设置 ExchangeRate API 密钥：**
在 `.env` 文件中定义 `EXCHANGE_API_KEY`（请查看 exchangerate-api.com 获取 API 密钥和文档）。
```
EXCHANGE_API_KEY=您的_API_密钥
```
4. **运行服务器：**
手动将 Claude Desktop 配置文件（`claude_desktop_config.json`）添加到：
```json
{
"mcpServers": {
"Exchange": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli],requests,python-dotenv",
"mcp",
"run",
"/完整路径/MCP-Exchange/main.py"
]
}
}
}
```
## 💻 使用 Claude Desktop 运行
1. 打开 Claude Desktop 应用程序。在 File > Settings > Developer 部分和聊天屏幕的设置中应会出现“Exchange”选项。
2. 点击聊天部分中的“Exchange”时，将自动列出 `get_exchange_rate` 工具。
3. 当询问“伦敦的汇率是多少？”时，`get_exchange_rate` 过程将开始。
4. 验证后，`get_exchange_rate` 将返回包含参数和结果的响应。
---
## 📋 API 工具
- `get_exchange_rate(base, target)`：获取两种货币之间的实时汇率信息
## 💡 示例用法
```
用户： "USD TRY 汇率是多少？"
AI： 自动触发 get_exchange_rate 函数
结果： {"rate": 40.28, "base": "USD", "target": "TRY", "last_updated": "..."}
```
---
## 🔧 开发
- Python 3.13+
- MCP Protocol
- ExchangeRate API
- 现代 uv 包管理器
## 📄 许可证
MIT License
---
**注意：** 与普通的汇率应用程序不同，该应用程序不是基于用户手动查询汇率，而是作为基于协议的工具运行。它在 MCP 框架内标准化和提供 JSON 格式的汇率数据。像 Claude Desktop 这样的 AI 模型根据用户的查询自动触发，无需手动干预。这使其成为一个无缝集成的后端服务，而不是一个独立的汇率应用程序。
