MCP Server

🚀 OilPriceAPI MCP Server

エネルギー商品のMCPサーバーです。 Claude、Cursor、VS Code、およびMCP互換のクライアント向けのリアルタイムの石油、ガス、および商品価格を提供します。

✨ 主な機能

• 4つのツール — 価格の取得、市場の概要、価格比較、商品リストの提供
• 4つのリソース — ブレント原油、WTI原油、天然ガス、およびすべての商品の購読可能な価格スナップショット
• 4つのプロンプト — 事前に作成されたアナリスト用テンプレート（日次ブリーフィング、スプレッド分析、ガス市場、商品レポート）
• 自然言語対応 — コードではなく、「ブレント原油」や「天然ガス」などの自然言語で問い合わせ可能
• 40以上の商品 — 石油、ガス、石炭、精製品、金属、外国為替

🚀 クイックスタート

npx oilpriceapi-mcp

📦 インストール

Claude Desktop

macOSの場合は~/Library/Application Support/Claude/claude_desktop_config.json、Windowsの場合は%APPDATA%\Claude\claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

プロジェクトの.mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

プロジェクトルートの.cursor/mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code + Cline

.vscode/mcp.jsonに以下を追加します。

{
  "servers": {
    "oilpriceapi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.jsonに以下を追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Cody (VS Code)

プロジェクトルートの.vscode/cody.jsonに以下を追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

グローバルインストール

npm install -g oilpriceapi-mcp

APIキーの取得方法

1. oilpriceapi.com/signupでサインアップします。
2. ダッシュボードからAPIキーを取得します。
3. 上記のようにMCP設定に追加します。

💻 使用例

get_commodity_price

特定の商品の現在の価格を取得します。

"What's the current Brent oil price?"
"Get the price of natural gas"

get_market_overview

すべての商品の価格を取得します。必要に応じてカテゴリ（oil、gas、coal、refined、all）でフィルタリングできます。

"Give me a market overview"
"Show all oil prices"

compare_prices

2 - 5種類の商品の価格を比較します。

"Compare Brent and WTI prices"
"What's the spread between US and European gas?"

list_commodities

利用可能なすべての商品とそのコードをリストします。

📚 詳細ドキュメント

リソース

購読可能な価格データ（JSON）：

プロンプト

事前に作成されたアナリスト用テンプレート：

対応商品

原油

• ブレント原油（世界基準）
• WTI原油（米国基準）
• ウラル原油（ロシア産）
• ドバイ原油（中東産）

天然ガス

• 米国ヘンリーハブ（$/MMBtu）
• 英国NBP（ペンス/サーム）
• ヨーロッパTTF（EUR/MWh）

石炭

• 石炭
• ニューキャッスル石炭（アジア太平洋地域）

精製品

• ディーゼル、ガソリン、RBOBガソリン、ジェット燃料、暖房用油

その他

• 金、EU炭素排出枠、英国炭素排出枠、EUR/USD、GBP/USD

自然言語対応

開発

npm install
npm run build
OILPRICEAPI_KEY=your-key node build/index.js

📄 ライセンス

MIT

リンク

• OilPriceAPI
• APIドキュメント
• 価格設定
• MCPプロトコル

他の提供形態

• Python SDK - Pandasと統合したPythonクライアント
• Node.js SDK - TypeScript/JavaScript SDK
• Go SDK - 慣用的なGoクライアント
• OpenBB統合 - OpenBBプラットフォームのプロバイダー