能源数据协议服务器

EIA MCP Server是为美国能源信息管理局(EIA)API提供的模型上下文协议服务器,用于访问电力和天然气数据。

  • by zen-tradings
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 zen-tradings/eia-mcp

使用说明

EIA MCP服务器

美国能源信息管理局(EIA)API的MCP(模型上下文协议)服务器,提供电力和天然气数据访问。

特性

电力数据

  • 零售额 -按州和部门、定价和客户数量分列的客户销售额
  • 操作数据 -月/年发电量、燃料消耗和排放量
  • RTO数据 -平衡机构(CISO、PJM、MISO、ERCOT等)的每小时/每天运营
  • 州概况 -州级电力概况和基础设施数据
  • 发电机容量 -美国可操作发电机库存。
  • 设施燃料 -单个发电厂运行数据

天然气数据

  • 摘要 -天然气调查数据概述
  • 价格 -现货价格、期货价格、城市门价格、住宅价格、商业价格、工业价格
  • 勘探与储量 -资源发现和库存水平
  • 生产 -产出指标和产量
  • 进口/出口 -跨境流量和管道移动数据
  • 存储 -库存水平、注射和提取
  • 消费 -按部门划分的最终用途数据

安装

cd eia-mcp
pip install -e .

配置

  1. 从获取API密钥 EIA开放数据
  2. 设置环境变量:
    export EIA_API_KEY=your_api_key_here
    

使用Claude Desktop

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "eia": {
      "command": "python",
      "args": ["-m", "eia_mcp.server"],
      "cwd": "/Users/yanpan/eia-mcp",
      "env": {
        "EIA_API_KEY": "your_api_key_here"
      }
    }
  }
}

或者,如果作为软件包安装:

{
  "mcpServers": {
    "eia": {
      "command": "eia-mcp",
      "env": {
        "EIA_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

工具 说明
eia_electricity_retail_sales 按州和行业获取电力零售销售数据
eia_electricity_operational_data 获取发电和燃料消耗数据
eia_electricity_rto 通过平衡权限获得实时网格操作
eia_electricity_state_profiles 获取国家级电力概况
eia_electricity_generator_capacity 获取发电机库存和容量数据
eia_electricity_facility_fuel 获取单个发电厂数据
eia_natural_gas_summary 获取天然气汇总数据
eia_natural_gas_prices 获取天然气价格数据
eia_natural_gas_exploration_reserves 获取勘探和储量数据
eia_natural_gas_production 获取生产数据
eia_natural_gas_imports_exports 获取导入/导出和管道数据
eia_natural_gas_storage 获取存储设施数据
eia_natural_gas_consumption 按行业获取消费数据
eia_explore_routes 探索可用的API路线和元数据

查询示例

自然地问克劳德:

  • “2024年加州的电力零售额是多少?”
  • “显示ERCOT当前的发电量”
  • “本周的天然气储量是多少?”
  • “得克萨斯州上个月发电量是多少?”
  • “比较不同地区的天然气价格”
  • “PJM现在的电力需求是多少?”
  • “显示2024年天然气进出口数据”

API 参考

基本URL: https://api.eia.gov/v2/

有关API的完整文档,请访问:https://www.eia.gov/opendata/documentation.php