能源数据分析工具

PG&E能源分析器是一款用于分析PG&E能源数据并提供优化建议的工具,支持太阳能系统检测、电池优化和费率计划比较。

  • by Proprius-Labs
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Proprius-Labs/PGE-Energy-MCP

使用说明

PG&E Energy Analyzer

Upload your PG&E energy data. Have a conversation about it. Get real answers.
The right rate plan. The right system size. The right battery strategy.

How It Works  •  Setup  •  What's Inside


“这是我的PG&E数据。帮助我优化能源成本。”

这就是整个提示。上传你的数据,问一个问题,这个工具会引导你完成一切——检测你的太阳系,询问你的电池,比较费率计划,并找到你把钱放在桌子上的地方。

现在在claude.ai上试试

  1. 首选 claude.ai/设置/连接器
  2. 点击 添加自定义连接器,命名它 pge-energy-mcp
  3. 输入URL: https://pge-energy-mcp.up.railway.app/mcp
  4. 上传您的PG&E数据并询问


Add the connector in Claude settings — takes 30 seconds

也与 克劳德桌面 作为a 独立web应用程序 --看 设置.

看实际效果


Upload your Green Button data and bill — get rate comparisons, usage breakdown, and actionable recommendations


Add Tesla data for battery performance analysis, solar production tracking, and dispatch optimization


为什么存在

太阳能产业的问题

太阳能公司向你出售尽可能大的系统。他们要求你支付电费,确定一个系统的大小以“覆盖”你的使用,然后继续前进。结果往往是一个超大的系统——太多的前期成本会产生比你使用的更多的成本。

更明智的做法是 首先了解你的用电量:你什么时候真正消耗电力?基本负荷、电动汽车充电和季节性供暖的比例是多少?你的峰值曝光量是多少?只有这样,你才能正确地确定一个平衡成本、生产和消费的系统的规模。

:zap:PG&E计费问题

PG&E的计费非常复杂,大多数客户不知道他们每千瓦时实际支付的费用。您的有效率取决于:

因素 为什么重要
费率表 EV2-A、E-ELEC、E-TOU-C、E-TOU-D都有不同的峰值窗口和定价
提供者 捆绑式PG&E与社区选择(PCE、SJCE、SVCE)的费率结构完全不同
复古PCIA 按您加入CCA的年份永久设置的每千瓦时收费(20+值)
NEM 版本 NEM 2.0出口获得全额零售信贷;NEM 3.0的收益减少了约75%
使用时间 在高峰时段(下午4点至9点),相同的千瓦时成本是非高峰时段的2-3倍
收入等级 基本服务费从0.20美元到0.79美元/天不等

利率每年大约变化两次,CCA利率独立变化。 此工具内置了实际关税率 --根据2026年3月生效的PG&E费率表进行验证。

:x:为什么不直接问克劳德?

如果没有这个工具,人工智能助手将:

问题 会发生什么
幻觉率 不知道EV2-A冬季淡季对PCE 2016年份客户来说是0.20635美元
混淆CCA与捆绑 PG&E账单显示 交付 利率,而非总额。真正的公式: delivery + CCA generation + PCIA
猜测NEM 3值 避免成本计算器有288个小时值(0.025-0.28美元)。人工智能猜测“0.08美元”
TOU小姐的差异 EV2-A峰值每天出现;E-TOU-D仅适用于工作日。错误的窗口=错误的数学
打破真实的数学 NEM信用每月累积,每年结算。事实就是账单

这个工具编码了所有的复杂性,所以克劳德给你 准确、个性化的答案.


运作原理

步骤1:上传您的PG&E数据

首选 pge.com 并下载两件事:

  1. 首选 myaccount.pge.com
  2. 点击 “绿色按钮——下载我的数据”
  3. 在下载窗口中向下滚动,保留默认值(导出所有账单总额,CSV格式),单击 出口
  4. 下载您的 最新账单PDF 从账户>账单


Look for the Green Button on your PG&E usage page

然后将两者上传到Claude并询问:

“这是我的PG&E数据和最新账单。帮助我优化能源成本。”

第二步:工具从那里开始

  Green Button data           Latest PG&E bill (PDF)
        |                              |
        v                              v
  Parse usage data              Read rate plan, NEM version,
  Detect solar exports          provider, vintage, income tier
        |                              |
        +--------- Combined ----------+
                      |
                      v
              "Do you have a battery?"
              (Tesla Powerwall, Enphase, etc.)
                      |
                      v
              Full analysis: rate comparison,
              usage profile, true-up projection,
              battery optimization, NEM transition impact

您的账单告诉了我们所需要的一切-费率表,无论您是PG&E捆绑的还是半岛清洁能源等CCA、NEM版本、PCIA年份和收入等级。你不需要自己去查。

步骤3:获取电池数据(如适用)

如果你有特斯拉Powerwall,有两种方法可以获取电池数据:

选项 如何 你得到什么
快速 特斯拉应用程序>设置>能源数据> 下载我的数据 月度总结
详细的 快跑 特斯拉太阳能下载 5分钟电力数据返回安装

详细的选项可以准确显示电池的充电和放电时间,捕捉到月度总结中遗漏的问题。

示例提示

你想知道什么 该问什么
最佳整体优化 “这是我的PG&E数据和账单。优化能源使用的最佳方法是什么?”
费率计划检查 “我的费率计划对吗?”
NEM 过渡影响 “我的NEM 2祖父身份将于明年到期。我还要多付多少钱?”
准确预测 “今年我的账单是多少?”
电池投资回报率 “添加第二个Powerwall能为我省钱吗?”
电池调度 “我应该在什么时候给Powerwall充电和放电,以最大限度地降低成本?”
带电Powerwall控制 “将我的Powerwall设置为自主模式并启用电网充电”

设置

Claude Desktop (Mac/Windows)
git clone https://github.com/paulmm/pge-energy-mcp.git
cd pge-energy-mcp
pip install -e .

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pge-energy": {
      "command": "/path/to/pge-energy-mcp/.venv/bin/python",
      "args": ["/path/to/pge-energy-mcp/server.py", "--stdio"]
    }
  }
}

重新启动克劳德桌面。您将在聊天输入中看到工具图标。

claude.ai / Remote (Streamable HTTP)
python server.py
# Runs on http://0.0.0.0:8000/mcp
Web App
python server.py --web
# Open http://localhost:8001
Deploy to Railway

包括 Procfile 在Railway的指定端口上运行MCP服务器。


里面有什么

分析工具

工具 它的作用 示例提示
费率计划比较 EV2-A、E-ELEC、E-TOU-C、E-TOU-D的年度成本,包括分时电价明细 “我的费率计划对吗?”
使用情况分析 峰值敞口、隔夜基本负荷、季节性模式、最糟糕的进口日 “分解我的能源使用情况”
校正投影 每月NEM余额累积和年度账单预测 “我的真相会是什么?”
NEM 2与3的比较 过渡影响、按分时电价计算的信贷损失、最糟糕的月份 “NEM 3要多花多少钱?”
电池优化 数学上最优的充电/放电时间表(Pyomo MILP求解器) “我的Powerwall什么时候充电?”
系统模拟器 模型添加面板、电池或更改调度策略 “更多的太阳能电池板会有帮助吗?”
季节性策略 分时变速和电池使用的季节性建议 “我该如何为夏天做准备?”

动力墙控制

如果你有特斯拉Powerwall,该工具可以读取实时状态并直接控制你的电池:

工具 它做什么
实时状态 实时电力流(太阳能、电池、电网、家庭)、电池百分比、电网状态
电池详细信息 根据电池健康状况、温度、太阳能电池串诊断
设置模式 在自耗、自主(TOU优化)和备份之间切换
设置储备 调整备份保留百分比(0-100%)
电网充电 启用/禁用电网充电(分时电价套利的关键)
网格导出 控制导出行为——电池+太阳能、仅太阳能或从不太阳能

需要 pypowerwall --通过您的特斯拉帐户连接到您的Powerwall。安装大约需要2分钟: pip install pypowerwall && python -m pypowerwall setup.

Rate引擎

对PG&E账单的全部复杂性进行编码,这样您就不必阅读关税PDF:

  • 4个费率表 有正确的分时电价窗口和季节性定价
  • CCA与捆绑 提供商费率(PCE完全支持,其他正在进行中)
  • 20+PCIA年份 (0.030美元-0.054美元/千瓦时,或-2025+的-0.010美元信用)
  • NEM 2.0版本 全额零售出口信贷
  • NEM 3.0 每小时避免成本计算器(所有小时和月份共288个值)
  • 基础服务费 按收入级别划分(0.20-0.79美元/天)
  • 历史汇率跟踪 用于跨速率变化边界的时间感知分析
  • 根据PG&E关税表验证的所有费率均有效 2026年3月1日

支持的费率表

时间表 高峰时段 高峰日 夏季 最适合
EV2-A 下午4点-9点 每天 6月-9月 电动汽车车主、电池系统、热泵
E-ELEC 下午4点-9点 每天 6月-9月 全电动家居
E-TOU-C 下午4-9点 每天 6月至9月 默认住宅TOU
E-TOU-D 下午5-8点 仅工作日 6月至9月 最短高峰时段,仅工作日

提供商

提供商 类型 覆盖范围
PGE_捆绑 PG&E捆绑服务 全价支持
PCE 半岛清洁能源 全额支持
SVCE、MCE、SJCE、EBCE 其他CCA 占位符配置——欢迎提供费率数据

Development

入门指南

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests (234 passing)
pytest

# Install CBC solver for battery optimizer
brew install cbc          # macOS
apt-get install coinor-cbc  # Linux

环境变量

当缺少凭据时,所有可选工具都会返回有用的设置说明。

变量 目的
DATA_DIR SQLite存储目录(默认: ./data)
TESLA_FLEET_TOKEN 特斯拉FleetAPI访问令牌
SOLCAST_API_KEY Solcast API密钥
PGE_CLIENT_ID PG&E共享我的数据OAuth客户端ID
PGE_CLIENT_SECRET PG&E共享我的数据OAuth客户端密钥

建筑

领域逻辑存在 src/ --MCP服务器和web应用程序是同一引擎上的精简包装器。

server.py                     # MCP tool definitions (21 tools)
src/parsers/                  # Green Button (hourly + billing), Tesla CSV
src/rates/                    # Rate engine, TOU classification, NEM credits
src/analysis/                 # Compare, usage, simulator, strategy, true-up, NEM transition
src/optimization/             # Pyomo MILP battery optimizer
src/integrations/             # Tesla FleetAPI, Solcast, PG&E Share My Data
src/storage/                  # SQLite config persistence
web/                          # FastAPI + Jinja2 + htmx web app
tests/                        # 234 tests

许可证

麻省理工学院

Built by Proprious Labs with Claude Code