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