Currency Exchange Service

货币兑换服务

提供实时汇率并列出支持币种的货币兑换服务。

功能

• 获取任意两种支持币种之间的当前汇率
• 列出所有支持的币种
• 支持 Docker，便于部署
• 基于 SSE（Server-Sent Events）的通信

前置条件

• Python 3.11 或更高版本
• Docker（可选，用于容器化部署）
• Git
• Exchange Rate API 密钥（从 https://www.exchangerate-api.com/ 获取）

安装

使用 Docker（推荐）

1. 克隆仓库：

git clone <repository-url>
cd <repository-name>

2. 按照项目根目录中 .env.example 的说明创建 .env 文件：

# Get your API key from https://www.exchangerate-api.com/
- `EXCHANGE_RATE_API_KEY`: Your Exchange Rate API key
- `GROQ_API_KEY`: Your GROQ API key

3. 构建并启动 Docker 容器：

docker compose up -d

直接使用 Python

1. 克隆仓库：

git clone <repository-url>
cd <repository-name>

2. 在项目根目录中创建 .env 文件：

# Get your API key from https://www.exchangerate-api.com/
EXCHANGE_RATE_API_KEY=your_api_key_here

3. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

4. 安装依赖：

pip install -r mcpserver/requirements.txt

使用方法

使用 Python 客户端

运行客户端脚本以与服务交互：

python mcpserver/client-sse.py

这将：

• 列出所有可用工具
• 显示汇率示例（INR 兑 USD）
• 显示支持币种列表

API 文档

该服务提供两个主要工具：

1. get_exchange_rate(from_currency, to_currency)

   • 返回两种货币之间的当前汇率
   • 示例：获取 USD 兑 EUR 的汇率

2. list_supported_currencies()

   • 返回所有支持币种的列表
   • 包含货币代码和名称

开发

要修改该服务：

1. 修改 mcpserver/server.py
2. 使用客户端脚本进行测试
3. 如果使用 Docker，请重新构建 Docker 容器：

docker compose build --no-cache
docker compose up -d

获取 API 密钥

1. 访问 https://www.exchangerate-api.com/
2. 注册免费账户
3. 从控制面板获取 API 密钥
4. 按照安装步骤中的说明将其添加到 .env 文件