MCP Metal Price

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

💻 使用例

基本的な使用法

このサーバーは get_gold_price という MCP ツールを提供します。

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>

応答形式

サーバーは以下の形式で価格データを返します。

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

📄 ライセンス

このプロジェクトは MIT ライセンスの条項に基づいてライセンスされています。詳細は LICENSE ファイルを参照してください。