MCP Metal Price

🚀 金属价格 MCP 服务器

金属价格 MCP 服务器借助 GoldAPI.io 服务，为用户提供当前和历史的黄金及其他贵金属价格信息，满足各类用户对贵金属价格数据的查询需求。

🚀 快速开始

本服务器使用简单，按以下步骤操作即可快速开启贵金属价格查询之旅：

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

   pip install -r requirements.txt
   

3. 设置 GoldAPI.io API 密钥作为环境变量：

   export GOLDAPI_API_KEY="your_api_key_here"
   

   （Windows 用户使用 set 替代 export）
4. 使用以下命令启动服务器：

python src/server.py

5. 服务器启动后，可通过 MCP 客户端如 Cline 或 Claude 连接。在您的 MCP 客户端中，使用以下命令连接：

cmd /c python src/server.py

✨ 主要特性

• 可获取黄金（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 工具 get_gold_price 用于获取当前或历史金属价格。

参数说明：

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

示例用法：

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

高级用法

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

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

响应格式

服务器返回价格数据的格式如下：

{
  "timestamp": 1713600000,
  "metal": "XAU",
  "currency": "USD",
  "price": 2345.67,
  "unit": "每盎司"
}

📄 许可证

此项目根据 MIT 许可证的条款进行授权。更多细节请查看 LICENSE 文件。