Metal Price MCP Server
2025.04.21
0
Python贵金属价格服务金融数据服务金融服务
Metal Price MCP Server 是一个提供当前和历史黄金/贵金属价格的服务，通过 GoldAPI.io 服务获取数据。该服务支持多种货币和金属类型，并可选地查询历史价格。
View on GitHub
Overview
基本能力
产品定位
Metal Price MCP Server 是一个专门用于获取贵金属价格的 MCP 服务，主要面向需要实时或历史贵金属价格数据的用户。
核心功能
- 获取黄金 (XAU)、白银 (XAG)、铂金 (XPT) 和钯金 (XPD) 的当前价格
- 支持多种货币（USD、EUR 等）
- 可选的历史价格查询功能（按日期）
适用场景
- 金融投资分析
- 贵金属交易系统
- 经济研究数据收集
- 财务报告生成
工具列表
- get_gold_price
- 能力：获取当前或历史的金属价格
- 参数：
currency（字符串，默认："USD"）：货币代码（ISO 4217 格式）metal（字符串，默认："XAU"）：金属符号（XAU, XAG, XPT, XPD）date（字符串，可选）：历史日期，格式为 YYYYMMDD
常见问题解答
- 如何设置 API 密钥？
通过环境变量
GOLDAPI_API_KEY设置您的 GoldAPI.io API 密钥。 - 支持哪些金属类型？ 支持黄金 (XAU)、白银 (XAG)、铂金 (XPT) 和钯金 (XPD)。
- 支持哪些货币？ 支持多种货币，包括 USD、EUR 等（具体取决于 GoldAPI.io 的支持）。
使用教程
使用依赖
- Python 3.7+
- 所需包：
mcp>=1.0.0requests>=2.31.0
安装依赖命令：
pip install -r requirements.txt
安装教程
- 克隆仓库
- 安装依赖（见上）
- 设置 GoldAPI.io API 密钥环境变量：
bash export GOLDAPI_API_KEY="your_api_key_here"（Windows 用户使用set代替export）
或者通过 cline_mcp_settings.json 文件手动安装：
"mcp_metal_price": {
"args": [
"/c",
"python",
"-m",
"mcp_metal_price"
],
"env": {
"GOLDAPI_API_KEY": "Your GOLDAPI_API_KEY"
}
}
调试方式
启动服务器：
python src/server.py
测试工具使用示例（在 MCP 客户端如 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>
预期响应格式：
{
"timestamp": 1713600000,
"metal": "XAU",
"currency": "USD",
"price": 2345.67,
"unit": "per troy ounce"
}