金属价格 MCP 服务器

一个通过 GoldAPI.io 服务提供当前和历史黄金/贵金属价格的MCP服务器。

特性

• 获取黄金 (XAU)、白银 (XAG)、铂金 (XPT) 和钯 (XPD) 的当前价格
• 支持多种货币 (USD, EUR 等)
• 可选按日期查询历史价格

要求

• Python 3.7+
• 包:
  • mcp>=1.0.0
  • requests>=2.31.0

设置

1. 克隆此仓库
2. 安装依赖项：

   pip install -r requirements.txt
   

3. 将您的 GoldAPI.io API 密钥设置为环境变量：

   export GOLDAPI_API_KEY="your_api_key_here"
   

   (Windows 用户: 使用 set 替换 export)

使用

该服务器提供了一个MCP工具：

安装

本服务器设计为手动安装，通过将其配置添加到 cline_mcp_settings.json 文件中来实现。

1. 在您的 cline_mcp_settings.json 文件中的 mcpServers 对象里添加以下条目：

"mcp_metal_price": {
  "args": [
    "/c",
    "python",
    "-m",
    "mcp_metal_price"
  ],
  "env": {
    "GOLDAPI_API_KEY": "Your GOLDAPI_API_KEY"
  }
}

get_gold_price

获取当前或历史金属价格。

参数：

• currency (字符串，默认: "USD")：货币代码（ISO 4217 格式）
• metal (字符串，默认: "XAU")：金属符号 (XAU, XAG, XPT, XPD)
• date (字符串，可选)：YYYYMMDD 格式的日期

示例用法：

{
  "currency": "EUR",
  "metal": "XAU"
}

运行服务器

使用以下命令启动服务器：

python src/server.py

与MCP客户端一起使用

一旦服务器运行起来，您就可以从 Cline 或 Claude 等MCP客户端连接到它。

连接到服务器

默认情况下，服务器在 stdio 上运行。在您的MCP客户端中，您可以使用以下方式连接：

cmd /c python src/server.py

使用 get_gold_price 工具

在 Cline/Claude 中使用工具的例子：

<use_mcp_tool>
<server_name>gold-price</server_name>
<tool_name>get_gold_price</tool_name>
<arguments>
{
  "currency": "USD",
  "metal": "XAU"
}
</arguments>
</use_mcp_tool>

响应格式

服务器以 JSON 格式返回价格数据：

{
  "timestamp": 1713600000,
  "metal": "XAU",
  "currency": "USD",
  "price": 2345.67,
  "unit": "per troy ounce"
}

许可证

该项目根据 MIT 许可证的条款获得许可。有关详细信息，请参阅 LICENSE 文件。