金属価格MCPサーバー
GoldAPI.ioサービスを通じて金/貴金属の現在の価格と過去の価格を提供する MCP サーバー。
特徴
- 金(XAU)、銀(XAG)、プラチナ(XPT)、パラジウム(XPD)の現在の価格を取得します
- 複数の通貨(USD、EURなど)のサポート
- 日付によるオプションの過去価格検索
要件
- Python 3.7以上
- パッケージ:
mcp>=1.0.0
requests>=2.31.0
設定
- このリポジトリをクローンする
- 依存関係をインストールします:
pip install -r requirements.txt
- GoldAPI.io API キーを環境変数として設定します。
export GOLDAPI_API_KEY="your_api_key_here"
(Windows ユーザー: export
の代わりにset
を使用してください)
使用法
サーバーは 1 つの MCP ツールを提供します。
インストール
このサーバーは、 cline_mcp_settings.json
ファイルに構成を追加することで手動でインストールできるように設計されています。
cline_mcp_settings.json
ファイルのmcpServers
オブジェクトに次のエントリを追加します。
"mcp_metal_price": {
"args": [
"/c",
"python",
"-m",
"mcp_metal_price"
],
"env": {
"GOLDAPI_API_KEY": "Your GOLDAPI_API_KEY"
}
}
金価格を取得する
現在の金属価格または過去の金属価格を取得します。
パラメータ:
currency
(文字列、デフォルト:"USD"):通貨コード(ISO 4217形式)metal
(文字列、デフォルト:"XAU"):金属記号(XAU、XAG、XPT、XPD)date
(文字列、オプション): YYYYMMDD形式の履歴日付
使用例:
{
"currency": "EUR",
"metal": "XAU"
}
サーバーの実行
次のコマンドでサーバーを起動します。
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ファイルをご覧ください。