Metal Price MCP Server

金属价格 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 文件。