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 ユーザーは export の代わりに set を使用してください）

使用方法

このサーバーは、1 つの 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 ファイルをご覧ください。