1 v0.9.2 更新于 2026-11-09
Aivy Energy MCP Server
Read and control your own home solar + battery: Sungrow, Sigenergy, FoxESS, AlphaESS, SolaX.
适用客户端
本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
安装配置
本地运行(pypi)
{
"mcpServers": {
"aivy-mcp": {
"command": "uvx",
"args": [
"aivy-mcp"
]
}
}
}将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。
提供的工具 接入后 Agent 可调用这 20 个工具
get_status
获取系统当前状态,包括电池SOC和太阳能、家庭、电网、电池四个功率流。
get_prices
获取当前及未来数小时的电价买卖信息并高亮最佳卖出时段。
plan_best_price_discharge
规划在最佳电价时段放电售电的方案,可一键应用。
get_registration_terms
获取注册/登录条款,支持在卡片中填写邮箱、密码和权限级别完成注册。
get_energy_mode
查看当前能量模式控制面板,包括当日时段、待返还状态和手动充放电操作。
list_vendors
列出支持的逆变器品牌,引导连接新系统。
get_curve
查看带SOC的太阳能、家庭、电池、电网功率历史曲线。
get_earnings
查看某日的净收益、收入、成本、输出和输入电量,按小时细分。
get_operations
查看平台执行的操作及其原因的时间线。
get_ai_plus
查看并调整 Ai+ 的控制参数(滑块和开关)。
plan_discharge_to_target
规划保留一定储备电量(如20%)的放电方案。
list_alerts
列出已设置的告警规则,支持删除和新增。
create_alert
创建新的告警规则,例如电池电量低于某值时提醒。
delete_alert
删除指定的告警规则。
list_sites
列出账户下的所有站点及其状态。
preview_strategy
预览AI编写的自定义策略规则及其当前效果。
start_strategy
启动已批准的自定义策略模式。
get_strategy
查看运行中策略的最后动作、近期决策和状态。
update_strategy_rules
更新运行中策略的规则。
end_strategy
停止并结束当前运行的自定义策略。