通过 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。
{ "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 也可免密钥使用。本地连接使用付费密钥即可获取实时价格。
{ "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 替换为你的密钥。