Exchange Rate MCP Server (Python)

Exchange Rate MCP Server (Python)

site icon
2025.04.12 0
Python货币汇率金融服务金融服务
Exchange Rate MCP Server 是一个基于 Python 实现的 Model Context Protocol (MCP) 服务器,提供实时的货币汇率数据。该服务器主要用于为 AI 模型提供最新的货币兑换信息,支持多种货币的汇率查询,并可通过配置更改基础货币。
View on GitHub

Overview

基本能力

产品定位

Exchange Rate MCP Server 是一个实时货币汇率数据服务,主要用于为 AI 模型提供最新的货币兑换信息。

核心功能

  • 提供多种货币的实时汇率数据
  • 可配置基础货币(默认为 USD)
  • 使用 exchangerate.host API 作为数据源
  • 包含客户端示例和 Ollama 集成

适用场景

  • AI 模型需要实时货币汇率数据的场景
  • 金融应用或服务需要汇率数据的场景
  • 开发者在测试或开发过程中需要模拟汇率数据的场景

工具列表

  • listTools: 列出服务器上可用的工具
  • callTool: 调用特定工具(如 exchange-rates)并传入参数

常见问题解答

  • API 密钥问题: 服务器可以在没有 API 密钥的情况下使用免费的公共 API。
  • API 不可用: 如果 API 不可用,服务器将回退到模拟数据。

使用教程

使用依赖

  1. 克隆仓库
git clone [email protected]:devshark/exchange-rate-mcp.git
cd exchange-rate-mcp
  1. 创建虚拟环境
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖
pip install -r requirements.txt
  1. 复制并编辑环境文件
cp .env.example .env

安装教程

  1. 编辑 .env 文件以配置端口和 API 密钥(可选)
  2. 启动服务器
python server.py

调试方式

  1. 使用客户端测试
python client.py
  1. 使用 Ollama 集成测试
ollama pull gemma3:27b
python ollama_client.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。