Frankfurter MCP
有疑问或遇到问题?欢迎在 GitHub Discussions 发帖。
通过官方 Model Context Protocol 服务器,直接在 AI 助手中换算货币、查询最新或历史汇率。每日数据可追溯至 1948 年。
将 https://mcp.frankfurter.dev/ 添加为远程 HTTP 服务器。无需 API 密钥或注册。
ChatGPT
- 打开 Settings,然后选择 Apps(或 Connectors)。
- 点击右上角的 Advanced settings,并启用 Developer mode 以允许自定义应用。
- 返回 Apps 子菜单,点击 Create app(或 Create connector)。
- 输入端点 URL:
https://mcp.frankfurter.dev/。 - 在身份验证(authentication)中选择 None。
Claude
在 Claude Code 中:
claude mcp add frankfurter https://mcp.frankfurter.dev/
在 Claude Desktop 或 Claude.ai 中:
- 打开 Settings,然后选择 Connectors。
- 点击 Add custom connector。
- 输入端点 URL:
https://mcp.frankfurter.dev/。 - 点击 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。