关于 GoldAPI Precious Metals Quotes
GoldAPI Precious Metals Quotes 是面向需要贵金属实时或历史价格的助手的 MCP 服务,覆盖黄金、白银、铂金和钯金的现货及期货市场,并提供报价和 K 线工具。
主要功能
- 01贵金属实时行情
- 02小时级 OHLCV 历史数据
- 03每日 OHLC 蜡烛图
- 04列出可查询品种和市场
- 05单次调用查询最多 50 个品种
适用场景
- 01查询黄金和白银现价
- 02查看小时级价格历史
- 03获取近期每日蜡烛图
- 04比较不同挂牌品种的报价
MCP 相关
通过 Streamable HTTP 向 MCP 客户端提供贵金属报价和历史数据工具。使用 Bearer 应用密钥访问,工具结果会报告计费渠道和剩余配额。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://www.gold-api.cn/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http hujuncheng-ddd-goldapi https://www.gold-api.cn/mcpCursor.cursor/mcp.json
{"mcpServers":{"hujuncheng-ddd-goldapi":{"type":"http","url":"https://www.gold-api.cn/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"hujuncheng-ddd-goldapi":{"type":"http","url":"https://www.gold-api.cn/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"hujuncheng-ddd-goldapi":{"type":"http","url":"https://www.gold-api.cn/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"hujuncheng-ddd-goldapi":{"serverUrl":"https://www.gold-api.cn/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
GoldAPI MCP — 面向 AI 助手的贵金属报价
GoldAPI MCP 是一款 MCP 服务,可让 AI 助手(Claude、Cursor、WorkBuddy、Cline 等) 查询实时和历史贵金属报价,包括黄金、白银、铂金和钯金, 涵盖上海黄金交易所、NYMEX/COMEX 和伦敦市场的现货与期货。
- 端点(Streamable HTTP):
https://www.gold-api.cn/mcp - 身份验证:
Authorization: Bearer YOUR_APPKEY(在 https://www.gold-api.cn/ 获取免费密钥,可免费调用 5,000 次) - 文档: https://www.gold-api.cn/docs.php(参见“MCP 接入”部分)
- 服务状态: https://www.gold-api.cn/status.php
工具
| 工具 | 描述 | 计费 |
|---|---|---|
list_varieties | 列出所有已挂牌品种,包含 goldId、名称、市场和类别 | 免费 |
get_realtime | 实时行情(最新价、涨跌、买价/卖价、最高价/最低价)。支持以逗号分隔的 goldid,每次调用最多查询 50 个品种 | 1 次调用 |
get_history | 按升序排列的小时级 OHLCV 历史数据,起始时间为 2026-05-27,每次请求最多 92 天 | 1 次调用 |
get_kline | 最近 N 天的日线 OHLC 蜡烛图(默认 30 天,最多 60 天) | 免费 |
计费采用与 REST API 相同的三渠道模式(按品种 / 会员 / 免费额度)。
每个付费工具结果都包含一个 billing 对象,其中列有渠道和剩余配额,
因此助手可以向用户报告用量。
安装
Claude Code
claude mcp add --transport http goldapi https://www.gold-api.cn/mcp \
--header "Authorization: Bearer YOUR_APPKEY"
Claude Desktop / Cursor / WorkBuddy(mcpServers JSON)
{
"mcpServers": {
"goldapi": {
"url": "https://www.gold-api.cn/mcp",
"headers": { "Authorization": "Bearer YOUR_APPKEY" }
}
}
}
示例提示词
- “用 GoldAPI 查一下黄金现货和白银 T+D 的最新价”
- “查询黄金现货(goldId 1061)最近 30 天的日线蜡烛图。”
注意事项
- 支持的协议版本:
2025-06-18、2025-03-26、2024-11-05(无状态 Streamable HTTP)。 - 付费工具需要有效的 appkey;
get_realtime支持单次调用查询最多 50 个品种(计为 1 次调用)。 - 免费套餐账户注册后可获得 5,000 次免费调用:https://www.gold-api.cn/pricing.php
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。