MCP 服务器文档

在 Cursor 中查询汇率

通过 MCP 将 Cursor 连接到货币汇率服务。

2026年10月25日 · 阅读时间:2 分钟

将 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 工具中。

~/.cursor/mcp.json
{  "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 分钟。

~/.cursor/mcp.json
{  "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。

~/.cursor/mcp.json
{  "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 表示已达每分钟限额或月度配额,请等到指定重试时间。

常见问题

可以免 API 密钥连接吗?

可以。免密钥请求共用配额池,每个 IP 每分钟限 10 次,每小时限 100 次。汇率延迟 15 分钟,与免费套餐相同。

MCP 调用如何计入配额?

每次 MCP 工具调用计为一次 API 调用。使用密钥时,与对应 REST 请求共用每分钟限额和月度配额,因此 MCP 调用会消耗套餐配额。

单个项目和所有项目分别用哪个配置文件?

项目根目录的 `.cursor/mcp.json` 仅为该项目添加服务器。所有项目使用 `~/.cursor/mcp.json`。保存文件后,重新加载 Cursor 的 MCP 设置或重启 Cursor。

服务器会自行购买套餐吗?

`start_checkout` 仅在用户确认后打开套餐结账页面,助手不会自行购买。所有套餐均可访问 MCP,包括免费套餐,无需打开付费结账页面。

继续阅读

获取免费 API 密钥

免费套餐每月含 5,000 次请求,无需信用卡。在 Cursor 中使用密钥,即可使用自己的配额。

获取免费密钥