有疑问或遇到问题?欢迎在 GitHub Discussions 发帖。

通过官方 Model Context Protocol 服务器,直接在 AI 助手中换算货币、查询最新或历史汇率。每日数据可追溯至 1948 年。

将 https://mcp.frankfurter.dev/ 添加为远程 HTTP 服务器。无需 API 密钥或注册。

ChatGPT

  1. 打开 Settings,然后选择 Apps(或 Connectors)。
  2. 点击右上角的 Advanced settings,并启用 Developer mode 以允许自定义应用。
  3. 返回 Apps 子菜单,点击 Create app(或 Create connector)。
  4. 输入端点 URL:https://mcp.frankfurter.dev/。
  5. 在身份验证(authentication)中选择 None。

Claude

在 Claude Code 中:

claude mcp add frankfurter https://mcp.frankfurter.dev/

在 Claude Desktop 或 Claude.ai 中:

  1. 打开 Settings,然后选择 Connectors。
  2. 点击 Add custom connector。
  3. 输入端点 URL:https://mcp.frankfurter.dev/。
  4. 点击 Add 完成设置。连接成功后,在聊天界面中开启该连接器。

其他客户端

添加到你的 MCP 配置中(Cursor、Windsurf、VS Code 等):

{
  "mcpServers": {
    "frankfurter": {
      "url": "https://mcp.frankfurter.dev/"
    }
  }
}

工具

连接后,你的助手可以使用以下工具:

convert
在两种货币之间换算金额。默认只返回换算后的金额及其货币。 设置 details: true 可同时返回汇率、生效日期以及所选的数据源(如有)。
参数:
  • amount(数值,必填):要换算的金额。
  • from(字符串,必填):源货币或资产代码(例如 USD、XAU 或 BTC)。
  • to(字符串,必填):目标货币或资产代码(例如 EUR)。
  • date(字符串,选填):用于历史换算的指定日期 YYYY-MM-DD。
  • provider(字符串,选填):数据源代码(例如 ECB 或 UST),用于获取单一机构公布的汇率而非综合汇率。对于按周、按月或按季度发布的数据源,传入其周期内的日期会返回当时有效的汇率。
  • details(布尔值,选填):包含汇率、生效日期和所选数据源(默认:false)。同币种换算返回汇率 1 和日期 null,不含数据源。
get_rates
查询参考汇率。
参数:
  • date(字符串,选填):汇率日期 YYYY-MM-DD(默认为最新)。
  • base(字符串,选填):基准货币或资产代码(默认:EUR)。
  • quotes(字符串或数组,选填):按货币或资产代码筛选结果。
  • provider(字符串或数组,选填):一个或多个数据源代码。以数据源自身的基准货币查询时,数字与其发布内容一致,并附带生效日期。
旧版别名 providers 仍然可用。provider 和 providers 只能二选一,不能同时使用。
list_currencies
查找支持的货币、贵金属和加密资产代码及其名称,包括历史货币。 省略筛选条件即可列出所有代码。
参数:
  • query(字符串,选填):代码或名称片段,不区分大小写。完全匹配的代码优先于部分匹配。
list_providers
查找数据源及其代码、汇率类型、频率和覆盖日期,以便选择 provider。 发布多个序列的数据源还会列出其数据集;将 NBP.B 等数据集代码作为 provider 传入即可选择其中一个。 筛选条件可组合使用,且不区分大小写。省略筛选条件即可列出所有数据源。
参数:
  • query(字符串,选填):数据源代码或名称片段。完全匹配的代码优先于部分匹配。
  • country(字符串,选填):两位字母的国家代码(例如 US)。
  • currency(字符串,选填):支持的货币代码,包括数据源的基准货币。

如果需要时间序列、历史区间或批量数据,请使用 REST API。