MCP Server

🚀 油價API MCP服務器

這是一個能源商品MCP服務器，可向Claude、Cursor、VS Code及其他任何支持MCP的客戶端提供即時的石油、天然氣和商品價格信息。

🚀 快速開始

npx oilpriceapi-mcp

✨ 主要特性

• 4種工具 — 獲取價格、市場概覽、價格比較、商品列表。
• 4種資源 — 可訂閱布倫特原油、西得克薩斯中質原油（WTI）、天然氣和所有商品的價格快照。
• 4種提示模板 — 預建的分析師模板（每日簡報、價差分析、天然氣市場、商品報告）。
• 支持自然語言 — 可以使用“布倫特原油”或“天然氣”等自然語言進行查詢，而非代碼。
• 40多種商品 — 涵蓋石油、天然氣、煤炭、精煉產品、金屬和外匯等。

📦 安裝指南

Claude桌面版

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

Claude代碼版

添加到項目的 .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，美國基準）
• 烏拉爾原油（俄羅斯）
• 迪拜原油（中東）

天然氣

• 美國亨利樞紐（美元/百萬英熱單位）
• 英國國家平衡點（便士/熱量單位）
• 歐洲TTF（歐元/兆瓦時）

煤炭

• 動力煤
• 紐卡斯爾煤炭（亞太地區）

精煉產品

• 柴油、汽油、RBOB汽油、噴氣燃料、取暖油

其他

• 黃金、歐盟碳排放配額、英國碳排放配額、歐元/美元、英鎊/美元

自然語言支持

🔧 技術細節

開發

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平臺提供商。