AI导哈

货币兑换服务

提供实时汇率查询和支持货币列表的货币兑换服务。

  • by ankitbelbase17
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ankitbelbase17/Currency_Exchange_MCP

使用说明

外币兑换服务

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

特性

  • 获取任意两种支持货币之间的当前汇率
  • 列出所有支持的货币
  • Docker支持，易于部署
  • 基于SSE（服务器发送事件）的通信

先决条件

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

安装

使用Docker（推荐）

  1. 克隆存储库：
git clone <repository-url>
cd <repository-name>
  1. 创建一个 .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
  1. 构建并启动Docker容器：
docker compose up -d

直接使用Python

  1. 克隆存储库：
git clone <repository-url>
cd <repository-name>
  1. 创建一个 .env 项目根目录中的文件：
# Get your API key from https://www.exchangerate-api.com/
EXCHANGE_RATE_API_KEY=your_api_key_here
  1. 创建并激活虚拟环境：
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  1. 安装依赖项：
pip install -r mcpserver/requirements.txt

用法

使用Python客户端

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

python mcpserver/client-sse.py

这将：

  • 列出所有可用工具
  • 显示汇率示例（印度卢比兑美元）
  • 显示支持的货币列表

API文档

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

  1. get_exchange_rate(from_currency, to_currency)

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

  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 如安装步骤所示的文件

相关 MCP