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上试试
- 首选 claude.ai/设置/连接器
- 点击 添加自定义连接器,命名它
pge-energy-mcp - 输入URL:
https://pge-energy-mcp.up.railway.app/mcp - 上传您的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 并下载两件事:
- 首选 myaccount.pge.com
- 点击 “绿色按钮——下载我的数据”
- 在下载窗口中向下滚动,保留默认值(导出所有账单总额,CSV格式),单击 出口
- 下载您的 最新账单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/mcpWeb App
python server.py --web
# Open http://localhost:8001Deploy 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
