Frankfurter

frankfurter-mcp

用于 Frankfurter 汇率 API 的官方 Model Context Protocol 服务。一个针对 Frankfurter v2 多来源综合参考汇率的轻量、无状态代理。

工具

• convert — 主要工具。转换两种货币之间的金额；返回一个四舍五入到目标货币最小单位的金额对象 { amount, currency }。传入 date 可查询历史汇率，传入 provider 可使用某家机构发布的汇率（例如 UST，美国财政部的季度报告汇率）。
• get_rates — 获取最新日期或指定 date 的综合参考汇率。可选参数包括 base、quotes 和 provider（或用于比较多家机构的 providers）。这是 convert 的原始汇率对应工具；使用 provider 和该机构自己的基准货币时，返回的数字与发布值一致，并附带生效日期。
• list_currencies — 返回支持的 ISO 4217 代码和名称，格式为 { code: name }。
• list_providers — 返回提供汇率的机构及其键、汇率类型、频率和覆盖日期，以便选择 provider。

如需时间序列、历史范围或批量查询，请直接使用 REST API：https://api.frankfurter.dev/v2。

汇率为每日参考汇率，并非实时交易汇率。不构成财务建议。

运行

npm install
npm run build
npm start            # listens on :3000, POST /

Docker：

docker build -t frankfurter-mcp . && docker run -p 3000:3000 frankfurter-mcp
docker run -p 3000:3000 ghcr.io/lineofflight/frankfurter-mcp:latest

预构建的 ghcr.io/lineofflight/frankfurter-mcp:latest 镜像会在每次发布时推送；也可以从源代码构建。

将任意 MCP 客户端指向 http://<host>:3000/（Streamable HTTP）。托管服务位于 https://mcp.frankfurter.dev/。

配置

• PORT — HTTP 端口（默认 3000）。
• FRANKFURTER_API_URL — 上游 API 基础地址（默认 https://api.frankfurter.dev）。 如有需要，可将其设为可自托管的 Frankfurter 实例。该值必须是主机根地址：其中的任何路径前缀都会被丢弃（例如，https://example.com/api 会解析为 https://example.com/v2/rates），因此可自托管实例必须可通过主机根地址访问。

开发

npm test       # vitest
npm run lint   # biome

许可证

MIT