将 exchangerate.dev MCP 服务器添加到 Cursor,让助手查询货币汇率并换算金额。托管服务器支持免密钥访问,汇率延迟 15 分钟。付费套餐通过同一端点获取实时汇率。
添加托管服务器
将以下配置保存到 ~/.cursor/mcp.json,用于所有项目;或保存到项目根目录的 .cursor/mcp.json。
配置项放在 mcpServers 下,用 url 通过 Streamable HTTP 连接 https://api.exchangerate.dev/v1/mcp/。保留末尾斜杠。连接无需 API 密钥。保存文件后,重新加载 Cursor 的 MCP 设置或重启 Cursor,服务器便会出现在 MCP 工具中。
{ "mcpServers": { "exchangerate-dev": { "url": "https://api.exchangerate.dev/v1/mcp/" } }}使用自己的配额
将以下配置中的 YOUR_API_KEY 替换为你的 API 密钥,保存文件,再重新加载 Cursor 的 MCP 设置或重启 Cursor。
配置通过 headers 添加 Authorization: Bearer YOUR_API_KEY。密钥使用所属套餐的配额和限额。免费套餐每月含 5,000 次请求,每分钟限 10 次。所有套餐均含 MCP 访问,包括免费套餐;免费套餐汇率延迟 15 分钟。
{ "mcpServers": { "exchangerate-dev": { "url": "https://api.exchangerate.dev/v1/mcp/", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } }}运行本地桥接
安装 Node.js 20 或更新版本,再在以下配置中填入 API 密钥,即可用本地桥接替代托管连接。
本地配置使用 command、args 和 env,通过 npx 启动 npm 桥接,并在环境变量中设置 EXCHANGERATE_API_KEY。桥接需要 API 密钥。保存文件后,重新加载 Cursor 的 MCP 设置或重启 Cursor。
{ "mcpServers": { "exchangerate-dev": { "command": "npx", "args": [ "-y", "@nusantara-ventures/exchangerate-mcp" ], "env": { "EXCHANGERATE_API_KEY": "YOUR_API_KEY" } } }}检查工具并查询汇率
确认 Cursor 列出全部九个工具,再问“现在 100 欧元能换多少日元?”
convert 根据 from、to 和 amount 回答该问题。问“9 月 1 日 USD 兑 IDR 的汇率是多少?”可通过 get_range 查询;问“能查询哪些货币?”可调用 list_currencies。
get_rate 接收 base 和 quote,查询最新汇率。get_range 查询日期范围内的汇率。get_usd_index 返回独立计算的 USD 指数,search_docs 搜索文档。
list_official_rate_tables 列出政府发布的汇率表,get_official_rate 获取政府发布的汇率。第九个工具 start_checkout 仅在用户确认后打开套餐结账页面。
查看汇率及其时间
Cursor 可读取返回的数值及其上下文:source、market_session 和 data_updated_at。请助手在引用汇率时注明时间。
换算响应含汇率和换算金额,若汇率经 USD 推算,还会附上标记。响应注明汇率仅供参考,不用于结算或交易。
修复连接错误
未显示工具时,检查 mcp.json 是否为有效 JSON。末尾多余的逗号是常见原因。
HTTP 401 表示请求头中的密钥有误。HTTP 429 表示已达每分钟限额或月度配额,请等到指定重试时间。