MCP 服务器文档

在 Cursor 中查询黄金价格

开发时,按货币或成色向 Cursor 查询黄金价格

2026年11月3日 · 阅读时间:2 分钟

通过 goldprice.dev MCP 服务器,在 Cursor 中查询黄金、白银和铜的价格。本地连接需要 API 密钥,远程连接无需密钥。付费套餐返回实时价格,Free 和免密钥访问的价格有延迟。

  • 本地配置需要 Node.js 和 goldprice.dev API 密钥。
  • 远程配置无需 Node.js 或 API 密钥。
  • Cursor 会显示每次工具调用,供你批准。

获取本地配置所需的免费 API 密钥

在 goldprice.dev 注册即可获取免费 API 密钥,无需信用卡。Free 套餐每月可调用 5,000 次,每分钟最多发送 10 次请求。

安装 Node.js,让 npx 能够运行本地服务器。如果不想安装 Node.js 或获取密钥,请使用下方的远程配置。

将本地服务器添加到 Cursor

打开仓库根目录下的 .cursor/mcp.json 或 ~/.cursor/mcp.json。在 mcpServers 下添加 goldprice 条目,通过 npx 运行 @nusantara-ventures/goldprice-mcp。

在 env 块的 GP_KEY 值中,将 YOUR_API_KEY 替换为你的密钥。修改 mcp.json 后,在“自定义”中关闭再开启服务器,或重启 Cursor。

mcp.json
{  "mcpServers": {    "goldprice": {      "command": "npx",      "args": [        "-y",        "@nusantara-ventures/goldprice-mcp"      ],      "env": {        "GP_KEY": "YOUR_API_KEY"      }    }  }}

也可连接远程服务器

在 mcp.json 的 mcpServers 下添加远程 goldprice 条目。使用 https://api.goldprice.dev/v1/mcp/,并保留末尾的斜杠。修改 mcp.json 后,重启 Cursor,或在“自定义”中关闭再开启服务器。

无需 Node.js 或密钥。不提供密钥时,可使用 get_spot_price、list_commodities、get_carat、search_docs、get_metadata和get_historical,get_physical_price 和 get_forward_view 返回 plan_gated 错误,start_checkout 返回 api_key_required。价格延迟 15 分钟。

不提供密钥时,get_historical 返回 30 天的每日历史数据,更长的历史数据需要付费套餐。get_metadata 也可免密钥使用。本地连接使用付费密钥即可获取实时价格。

mcp.json
{  "mcpServers": {    "goldprice": {      "url": "https://api.goldprice.dev/v1/mcp/"    }  }}

向 Cursor 查询价格

在 Cursor 的聊天或智能体面板中提问。Cursor 会显示每次工具调用,你可以批准后再将结果用于工作。

“以 INR 计价的 22K 黄金每克多少钱?”会调用 get_carat。本地服务器和免密钥远程连接均支持此查询。

“获取上个月白银的每日收盘价”会调用 get_historical。免密钥访问支持 30 天的历史数据,更长的历史数据需要付费套餐。

Cursor 可以读取哪些数据

免密钥远程连接支持 get_spot_price、list_commodities、get_carat、search_docs、get_metadata和get_historical,包括 30 天的每日历史数据。

日内 K 线需要 Plus 或 Pro。通过 get_physical_price 获取经销商报价需要 Basic 或更高套餐。get_forward_view 仅限旧版套餐。

这些价格仅供参考,不构成交易要约。购买套餐会调用 start_checkout,并需要你的确认。

遇到问题时

如果没有显示工具,请检查 mcp.json 的 JSON 格式,包括是否有多余的末尾逗号。修改 mcp.json 后,在“自定义”中关闭再开启服务器,或重启 Cursor。

invalid_api_key 错误表示密钥有误或缺失。请确认 GP_KEY 位于本地条目的 env 块中,并已将 YOUR_API_KEY 替换为你的密钥。

常见问题

在 Cursor 中查询黄金价格需要付费吗?

你可以免密钥使用远程连接,也可以获取免费 goldprice.dev API 密钥,无需信用卡。Free 套餐每月可调用 5,000 次。如需实时价格,则需要付费套餐。

Cursor 获取的价格有多久延迟?

goldprice.dev 的 Free 和免密钥访问价格延迟 15 分钟,付费套餐返回实时价格。要在 Cursor 中使用付费密钥,请选择本地 MCP 配置,并在其 env 块中设置 GP_KEY。

Cursor 可以使用哪些工具?

本地服务器提供九个工具:get_spot_price、list_commodities、get_metadata、get_carat、get_historical、search_docs、get_physical_price、get_forward_view 和 start_checkout。访问权限取决于你的套餐。get_forward_view 仅限旧版套餐,购买套餐需要你的确认。

不安装 Node.js 也能连接 Cursor 吗?

可以。在 Cursor 的 MCP 配置中添加 https://api.goldprice.dev/v1/mcp/,并保留末尾的斜杠。无需 Node.js 或密钥。get_spot_price、list_commodities、get_carat、search_docs、get_metadata和get_historical 支持免密钥使用,包括 30 天的每日历史数据。更长的历史数据需要付费套餐。

继续阅读

从免费 API 密钥开始

免费套餐每月提供 5,000 次请求。无需信用卡。

获取免费密钥