项目简介

Frankfurter MCP 是一个专业的货币汇率查询服务器，通过标准化的 MCP 协议为 AI 助手提供汇率数据服务。它连接到 Frankfurter API，支持查询最新汇率、历史汇率、货币转换等完整功能。

主要功能

• 支持货币列表查询：获取所有可用的货币代码（如 USD、EUR、GBP）
• 实时汇率查询：查看指定货币的最新汇率
• 货币实时转换：使用最新汇率进行货币金额转换
• 历史汇率查询：查看特定日期或日期范围内的汇率数据
• 指定日期货币转换：使用历史某一天的汇率进行货币转换
• 缓存优化：内置 LRU 和 TTL 缓存机制，提升查询效率
• 多种传输方式：支持 stdio、SSE 和 streamable-http 等多种协议

安装步骤

1. 安装依赖：使用 pip 安装包

   pip install frankfurtermcp
   

2. 环境配置（可选）：复制 '.env.template' 文件为 '.env' 并根据需要修改环境变量

服务器配置

在 MCP 客户端（如 Claude Desktop、VS Code）中添加以下配置：

使用 uv 运行（推荐）：

{
  "command": "uv",
  "args": ["run", "frankfurtermcp"]
}

使用 Python 模块运行：

{
  "command": "python",
  "args": ["-m", "frankfurtermcp.server"]
}

配置说明：

• 'command'：指定运行命令（uv 或 python）
• 'args'：指定运行参数，其中 'frankfurtermcp' 或 'frankfurtermcp.server' 是服务器入口点

基本使用方法

1. 启动服务器：按照上述配置在客户端中启用
2. 连接测试：使用 MCP Inspector 工具验证连接状态

• 功能调用：AI 助手可直接调用汇率查询工具，无需额外配置
• 云端服务：也可使用已部署的云端版本，无需本地安装