外币兑换服务
一种货币兑换服务，提供实时汇率并列出支持的货币。
特性
- 获取任意两种支持货币之间的当前汇率
- 列出所有支持的货币
- Docker支持，易于部署
- 基于SSE（服务器发送事件）的通信
先决条件
- Python 3.11或更高版本
- Docker（可选，用于容器化部署）
- Git
- 汇率API密钥（从获取https://www.exchangerate-api.com/)
安装
使用Docker（推荐）
- 克隆存储库：
git clone
cd - 创建一个
.env按照指示归档.env.example在项目根目录中：
# 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- 构建并启动Docker容器：
docker compose up -d直接使用Python
- 克隆存储库：
git clone
cd - 创建一个
.env项目根目录中的文件：
# Get your API key from https://www.exchangerate-api.com/
EXCHANGE_RATE_API_KEY=your_api_key_here- 创建并激活虚拟环境：
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate- 安装依赖项：
pip install -r mcpserver/requirements.txt用法
使用Python客户端
运行客户端脚本以与服务交互：
python mcpserver/client-sse.py这将：
- 列出所有可用工具
- 显示汇率示例（印度卢比兑美元）
- 显示支持的货币列表
API文档
该服务提供两个主要工具：
get_exchange_rate(from_currency, to_currency)
- 返回两种货币之间的当前汇率 - 示例：获取美元兑欧元汇率
list_supported_currencies()
- 返回所有支持的货币列表 - 包括货币代码和名称
发展
要修改服务，请执行以下操作：
- 对以下内容进行更改
mcpserver/server.py - 使用客户端脚本进行测试
- 如果使用Docker，请重建Docker容器：
docker compose build --no-cache
docker compose up -d获取API密钥
- 访问https://www.exchangerate-api.com/
- 注册一个免费帐户
- 从仪表板获取API密钥
- 将其添加到您的
.env如安装步骤所示的文件