goldprice.devのMCPサーバーを通じて、Cursorで金、銀、銅の価格を取得できます。APIキーを使うローカル接続と、キー不要のリモート接続に対応しています。有料プランはリアルタイム価格を返し、Freeとキーなしの価格は遅延します。
- ローカル接続にはNode.jsとgoldprice.devのAPIキーが必要です。
- リモート接続にはNode.jsもAPIキーも不要です。
- Cursorではツール呼び出しが表示され、承認できます。
ローカル接続用の無料APIキーを取得する
goldprice.devに登録すると、クレジットカードなしで無料APIキーを取得できます。Freeの上限は月間5,000回、毎分10リクエストです。
npxでローカルサーバーを実行するため、Node.jsをインストールしてください。Node.jsのインストールやキーの取得なしで接続する場合は、下記のリモート接続を使います。
Cursorにローカルサーバーを追加する
リポジトリ直下の.cursor/mcp.json、または~/.cursor/mcp.jsonを開きます。mcpServersにgoldpriceを追加します。npxで@nusantara-ventures/goldprice-mcpを実行する設定です。
envブロックのGP_KEYの値で、YOUR_API_KEYを自分のキーに置き換えます。mcp.jsonを編集したら、Customizeでサーバーをオフにしてからオンに戻すか、Cursorを再起動します。
{ "mcpServers": { "goldprice": { "command": "npx", "args": [ "-y", "@nusantara-ventures/goldprice-mcp" ], "env": { "GP_KEY": "YOUR_API_KEY" } } }}リモートサーバーに接続する場合
mcp.jsonのmcpServersにリモート接続用のgoldpriceを追加します。URLはhttps://api.goldprice.dev/v1/mcp/を使い、末尾のスラッシュは残してください。編集後、Cursorを再起動するか、Customizeでサーバーをオフにしてからオンに戻します。
Node.jsもキーも不要です。キーなしではget_spot_price、list_commodities、get_carat、search_docs、get_metadata、get_historicalが利用でき、get_physical_priceとget_forward_viewはplan_gatedエラー、start_checkoutはapi_key_requiredを返します。価格は15分遅延します。
キーなしのget_historicalでは30日分の日次履歴を取得できます。それより長い履歴には有料プランが必要です。get_metadataもキーなしで使えます。ローカル接続で有料キーを使うと、リアルタイム価格を取得できます。
{ "mcpServers": { "goldprice": { "url": "https://api.goldprice.dev/v1/mcp/" } }}Cursorに価格を質問する
Cursorのチャットかエージェントパネルで質問します。ツール呼び出しが表示されるので、結果を作業に使う前に承認できます。
「22Kの金のグラム単価をINRで教えてください」ではget_caratを使います。ローカルサーバーでも、キーなしのリモート接続でも利用できます。
「先月の銀の日次終値を取得してください」ではget_historicalを使います。キーなしで30日分を取得でき、それより長い履歴には有料プランが必要です。
Cursorで取得できる情報
キーなしのリモート接続ではget_spot_price、list_commodities、get_carat、search_docs、get_metadata、get_historicalに対応し、30日分の日次履歴も取得できます。
日中の価格バーにはPlusかProが必要です。get_physical_priceによる販売店価格にはBasic以上が必要です。get_forward_viewは旧プラン専用です。
価格は参考情報であり、その価格で取引できることを示すものではありません。プラン購入にはstart_checkoutを使い、利用者の確認が必要です。
問題が起きた場合
ツールが表示されない場合は、mcp.jsonのJSON形式を確認してください。末尾の余分なカンマなどが原因になります。編集後、Customizeでサーバーをオフにしてからオンに戻すか、Cursorを再起動します。
invalid_api_keyエラーは、キーが間違っているか未設定であることを示します。ローカル接続設定のenvブロックにGP_KEYがあり、YOUR_API_KEYを自分のキーに置き換えているか確認してください。