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 文件。