金属价格查询服务

金属价格MCP服务器

MCP服务器，通过以下方式提供当前和历史黄金/贵金属价格 GoldAPI.io 服务。

特性

• 获取黄金（XAU）、白银（XAG）、铂金（XPT）和钯金（XPD）的当前价格
• 支持多种货币（美元、欧元等）
• 可选按日期查询历史价格

需求

• 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. 将以下条目添加到 mcpServers 对象在你 cline_mcp_settings.json 文件：

"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"
}

许可证

该项目根据麻省理工学院许可证条款获得许可。看 许可证 文件以获取详细信息。