InfraMap

InfraMap MCP 服务

InfraMap MCP 服务为 AI 助手提供对 InfraMap Pro 美国电力市场数据的只读访问权限：涵盖所有正在运营的美国发电厂及其发电量、排放、所有权和电力承购信息，以及七个市场的 ISO 节点价格、枢纽价格和价差。该服务提供 43 个工具，每个结果都附带来源、时间段和覆盖范围。

• 服务 URL： https://mcp.inframap.pro/mcp（Streamable HTTP）
• 登录： OAuth。客户端首次连接时会打开 InfraMap 登录页面。
• 账户： InfraMap Pro、Team 或 Enterprise 套餐。请参阅定价。
• 收录于： Claude 的连接器目录
• 18 款客户端的设置说明： mcp.inframap.pro 和文档

该服务由 InfraMap 托管。本仓库包含其文档、客户端配置、注册表条目和 Claude Code 插件；服务的源代码未在此处发布。

可以询问的问题

• 显示 Barry 在 2024 年报告的月度发电量，包括缺失月份以及每个数值的来源。
• 各 ISO 有多少座电厂拥有经过审核的市场价格节点，又有多少座没有？
• 哪些风电和太阳能电厂的模型预测弃电量从 2024 年到 2025 年增幅最大？请显示有抵免和无抵免两种估算区间。
• 估算 Moccasin 在 2025 年 1 月至 6 月的批发电力收入，并说明使用的价格节点。
• 哪些燃煤电厂报告的冷却用水取水量最高？各厂址的水资源压力如何？

更多示例请参阅 examples/prompts.md。

连接

Claude（网页、桌面和移动端）

打开连接器目录中的 InfraMap，然后选择 Connect。Claude 会打开 InfraMap 登录页面。

如果你无法访问该目录，请依次前往 Customize、Connectors，选择 Add custom connector，将其命名为 InfraMap，并粘贴 https://mcp.inframap.pro/mcp。

Claude Code

claude mcp add --transport http --scope user inframap https://mcp.inframap.pro/mcp

然后在 Claude Code 中运行 /mcp，选择 inframap，再选择 Authenticate。若要将服务与 InfraMap 研究技能一同安装，请使用本仓库中的插件：

/plugin marketplace add inframaporg/mcp
/plugin install inframap@inframap

ChatGPT

前往 chatgpt.com/plugins，选择 +，然后选择 Add custom MCP server。将其命名为 InfraMap，粘贴 https://mcp.inframap.pro/mcp，将 Authentication 设为 OAuth，然后选择 Create as a plugin。在聊天中输入 @ 并选择 InfraMap。

Codex

codex mcp add inframap --url https://mcp.inframap.pro/mcp
codex mcp login inframap

Cursor

添加到 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json（适用于单个项目）：

{
  "mcpServers": {
    "inframap": {
      "url": "https://mcp.inframap.pro/mcp"
    }
  }
}

然后，Cursor 会在 Customize、MCPs 下显示 inframap 的登录提示。

VS Code

code --add-mcp '{"name":"inframap","type":"http","url":"https://mcp.inframap.pro/mcp"}'

也可以将 .vscode/mcp.json 添加到项目中：

{
  "servers": {
    "inframap": {
      "type": "http",
      "url": "https://mcp.inframap.pro/mcp"
    }
  }
}

Gemini CLI

gemini mcp add --transport http --scope user inframap https://mcp.inframap.pro/mcp

其他客户端

大多数客户端都支持通过名称和 URL 添加远程服务。请使用 Streamable HTTP；该服务没有 SSE 端点。对于只能启动本地服务的客户端，开源的 mcp-remote 桥接工具可转发至 InfraMap 并处理登录：

{
  "mcpServers": {
    "inframap": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.inframap.pro/mcp"
      ]
    }
  }
}

各客户端的配置文件位于 examples/ 中。

工具

所有 43 个工具均为只读。请从 get_data_catalog 开始，了解每个数据集的涵盖范围及其时效性。

分析师存储

使用 SQL 筛查全量清单、一次调用获取项目档案，以及查阅审核过的定义。

工具	功能
query_analyst_store	查询分析师存储（SQL）。 对分析师存储执行一次只读 SQLite SELECT，以筛查、排序、计数或比较全量清单中的项目。最多返回 200 行，并附带存储版本和表格引用。
get_project_profile	获取项目档案。 一次获取最多 5 个项目的档案：身份信息、容量、地区、定价节点和枢纽、价格链中的较早节点、近期发电量和容量因子、所有权、售电情况，以及 2024–2025 年的价格和基差。
get_energy_reference	查询能源定义。 查询能源术语和研究主题（如容量因子、基差、捕获率、ELCC 和弃电）的审核过的定义、公式、注意事项和主要参考资料。

数据发现与定义

了解有哪些数据、数据的时效性，以及读取数据所用的工具。

工具	功能
get_data_catalog	查看数据目录。 查看所有获批数据源及其数据截至日期、覆盖范围、工具和限制。请先调用此工具。
discover_energy_data	查找数据集。 按研究术语搜索数据集，或查看单个数据集 ID 的含义、粒度、联接规则和覆盖范围。
get_source_catalog	列出已加载的来源数据集。 查看已加载的来源表（水、锅炉燃料、公用事业、天然气运营商、EQR 合同、建模的可再生能源发电曲线）及其粒度、字段和注意事项。
get_analysis_guide	获取分析指南。 查阅审核过的术语、公式、研究核对清单和研究设计主要参考资料。
explain_analysis_limit	说明分析限制。 说明已知的数据缺口、所需输入，以及最接近且受支持的替代方案。

项目与地区

查找电厂、确定电网区域，并读取来源级的项目证据。

工具	功能
search_energy_projects	搜索发电厂。 按州、燃料、ISO、平衡管理机构、县、规模和混合类型，筛选、排序并分页浏览当前运营中的 EIA 目录。混合项目的组件只分组显示一次。
get_project_details	获取发电机和电厂详情。 查询确切 EIA 电厂 ID 对应的发电机和电厂字段，并支持发电机分页。
get_project_evidence_bundle	获取项目证据包。 按章节获取最多 5 个项目、最长 60 个月的精简核实证据和年度摘要。
resolve_grid_areas	确定电网区域。 在筛选电厂前，根据代码、名称或别名确定 ISO、RTO 或平衡管理机构。
get_project_grid_membership	获取项目电网归属。 查询单个项目按日期记录的机组级平衡管理机构关系，包括审核过的变更。
get_project_source_coverage	获取项目来源覆盖情况。 查看哪些来源数据集包含项目记录，以及用于查询这些数据集的原生 ID。
get_grid_topology	获取电网网络覆盖情况。 查看公开的 OpenStreetMap 网络覆盖情况，以及每个项目的 USGS 和 OSM 几何要素数量。

发电量、排放、所有权

报告的产量、绩效、潜力、排放和所有权。

工具	功能
get_project_generation	获取项目发电量。 EIA-923 月度净 MWh，电池充电和放电分别统计。
get_project_performance	获取项目绩效。 最多 5 个项目的完整时段发电量、按日期计算的铭牌容量因子、电池流量和利用率。
get_project_generation_potential	比较发电量与建模潜力。 将实际发电量与经审核的物理潜力和回溯预期发电量并列比较。
get_project_emissions	获取项目排放。 通过 PUDL CAMD–EIA 交叉映射关联的受监测机组年度 EPA CO₂、SO₂ 和 NOx 排放质量。单位为美制短吨。
get_project_ownership	获取项目所有权。 按日期记录的所有权和购电结论，以及报告的发电机组关系。
rank_generation_change	对发电量变化进行排名。 在筛选后的机组群中，对两年相同月份之间报告的净发电量变化进行排名。
rank_capacity_factors	对风电容量因子进行排名。 先按运营中的风电铭牌容量选出最大的风电项目，再对其容量因子进行排名。

市场

七个 ISO 和 RTO 的实时 5 分钟价格、节点和枢纽价格、基差、时段分析及建模收入。

工具	功能
get_eqr_hourly_sales	获取 FERC EQR 小时销售数据。 约 430 座电厂在 2026 年第 2 季度按交付点统计的卖方报告小时销售数据。此为报告的销售量，而非计量发电量。
get_live_prices	获取实时 5 分钟价格。 所有枢纽和区域的最新 5 分钟实时价格；或单个枢纽最多 8 天、单座电厂定价节点最多 2 天的价格；或从存档获取最多 62 天的小时实时和日前价格，并包含阻塞和损耗分量及日前与实时价格对比。所有七个市场每 5 分钟更新一次。
get_project_market_prices	获取项目市场价格。 覆盖情况，或 ERCOT 以外电厂（CAISO、ISO-NE、MISO、NYISO、PJM、SPP）单个月份的价格统计数据。
get_ercot_project_data	获取 ERCOT 项目数据。 ERCOT 单月资源净能量（SMNE）、节点和枢纽结算点价格及基差。
analyze_market_period	分析市场时段。 在七个市场中的任意市场，对最多 5 个项目、最长 12 个月的价格、基差和覆盖情况进行分析。
model_project_revenue	建模项目能源收入。 历史建模能源收入：EIA 月度净发电量乘以同月节点平均价格。
rank_ercot_basis	对 ERCOT 基差进行排名。 按一个月、一个枢纽和一个市场中的节点价格减枢纽价格，对经审核的 ERCOT 项目进行排名。
assess_capture_rate_coverage	检查捕获率覆盖情况。 检查能否为项目计算精确捕获率，以及缺少哪些数据。

限电

实验性建模限电范围，以及运营商发布的区域历史数据。

工具	功能
compare_project_curtailment	比较建模限电。 按全国范围或 ISO、州或技术类别，筛选或比较匹配月份窗口中所有符合条件的机组群的建模限电情况。
investigate_project_curtailment	调查建模限电。 对最多 5 座电厂在最长 366 天内进行小时级调查：损失区块、持续时间、价格重合情况和季节性。
get_project_modeled_curtailment	获取建模限电。 某座电厂某一年的月度建模限电 MWh、预期限电小时数和物理潜力。
get_regional_curtailment_history	获取运营商限电历史。 运营商发布的区域限电数据：CAISO 2015–2025 年，SPP 2024–2025 年。

ERCOT 电池

审查 RTC+B 前后的 ERCOT 电池运行情况。

工具	功能
get_project_battery_operations	获取 ERCOT 电池运行情况。 电池资源覆盖范围，或一个月的运行能源数据。
analyze_battery_period	分析 ERCOT 电池运行情况。 分析最多 5 座电厂、最长 24 个月的电池运行情况，并将两种计量制度分开处理。

源记录

对已加载的源数据表进行逐行读取、计算和排名。

工具	功能
query_source_records	查询源记录。 查找准确的实体 ID，然后读取附有单位和引用的精简记录。
summarize_source_records	汇总源记录。 汇总 1–5 个实体在所有匹配记录中的总量和热耗率，最多覆盖 60 个月。
rank_source_records	为源记录排名。 先按数据集自身的粒度为所有记录排名，再选取排名靠前的行。

电网和天气

按平衡区域管理机构提供每小时负荷、燃料结构和碳强度，并提供每座风电和太阳能电厂的定点天气数据。

工具	功能
get_grid_hourly	获取每小时负荷、燃料结构和碳数据。 提供最多 4 个 ISO 或平衡区域管理机构的数据，包括 EIA-930 需求、预测、净发电量、交换电量、按燃料分类的发电量，以及每小时 CO₂ 强度；时间跨度最长 92 天，每小时更新。
get_plant_weather	获取电厂天气数据。 提供风电或太阳能电厂自 2010 年以来的轮毂高度风速、辐照度和温度小时数据，时间窗口最长 31 天。
explain_output_with_weather	根据天气核查发电量。 将月度容量因子与根据电厂自身天气预测的发电量进行对比，并标记低于预期值 60% 的月份。此项为模型估算。

水资源

电厂冷却用水，以及各电厂所在流域的水资源压力。

工具	功能
get_plant_water_use	获取电厂冷却用水和水资源压力。 提供按电厂统计的 EIA 冷却水取水量和耗水量，并关联 USGS 地表水资源压力指数（按电厂位置），覆盖约 730 座电厂。

数据

截至 2026 年 11 月 1 日的统计。所有数据集的实时数据量、时间范围和注意事项见数据来源页面。

• 电厂： 来自 EIA-860M（2026 年 8 月）的 14,233 座在运电厂和电池，归为 14,225 个项目，铭牌容量合计 1,391 GW。
• 发电量： 来自 EIA-923 的月度净发电量，时间范围为 2000 年 1 月至 2026 年 7 月。
• 排放和用水： 1995 年至 2025 年的 EPA 排放数据、冷却用水量和水资源压力。
• 价格： CAISO、ERCOT、ISO-NE、MISO、NYISO、PJM 和 SPP 的 3,466 个电厂定价节点的日前和实时小时节点价格、枢纽价格及基差，以及全部 7 个 ISO 的实时枢纽价格（每 5 分钟更新）。
• 负荷和燃料结构： 自 2015 年 7 月起，所有平衡区域管理机构的 EIA-930 每小时需求、预测、交换电量和按燃料分类的发电量。
• 所有权和承购： 3,150 个项目的所有者和母公司信息，以及来自 473 家买方的 2,610 份承购合同。
• 模型数据： 物理潜力、预期发电量和模型计算的限电量，均始终标注为模型数据。

结果报告方式：

• 观测值、计算值和模型值相互区分并分别标注。
• 缺失不等于零：null 表示源数据中没有可用记录。零值和负值按原始报告显示。
• 每个数据集保留自身的时间范围，并在每项结果中注明。
• 与电厂关联的定价节点、枢纽或平衡区域仅表示关联，并不能证明存在结算、合同或物理连接。

方法说明页面介绍了电厂的归组方式，以及容量因子、潜力、限电量、价格和基差的计算方法。

限制

• 每个账户每分钟约 120 次请求，同时最多处理 2 个请求。建议优先使用一次 query_analyst_store 查询，而不是针对多个电厂分别进行单次查询。
• query_analyst_store 会基于已公开说明的架构运行一条只读 SQLite SELECT 查询，并最多返回 200 行。
• 仅提供美国数据。该服务不提供投资建议、住宅零售电价或客户账户数据。

安全与隐私

• 安全和漏洞报告。另请参阅 SECURITY.md。
• 隐私政策，其中涵盖 MCP 请求日志和 OAuth 令牌
• 服务条款和可接受使用政策
• 子处理方

支持

请发送邮件至 [email protected]，或在此代码仓库中提交 issue，反馈文档和设置方面的问题。

关于

InfraMap Pro 是一个美国电力市场数据平台，面向能源分析师、开发者、资产管理者、电力购买方和交易员，提供网页地图、AI 分析师和此 MCP 服务。InfraMap Edu（edu.inframap.org）是一个独立的免费应用，用于学习电网的运作方式，不包含 Pro 的数据或此服务。InfraMap Pro 与 Open Infrastructure Map、Cycloid 的 Terraform 图表工具 InfraMap、InfraMap Corp. 或 iWater 的 infraMAP 均无关联。

许可证

此代码仓库中的文档和配置文件基于 MIT License 发布。InfraMap 服务及其数据的使用受服务条款约束。