fronius-mcp

fronius-mcp

直接在 Claude 中查看 Fronius 逆变器的实时太阳能数据。

可以询问：

“我现在正在发多少太阳能？”

“我的电池电量是多少？”

“我现在是在从电网购电还是向电网送电？”

“我今年产生了多少能源？”

“你能用我的太阳能系统做什么？”

“帮我分析一下我的光伏系统。”

直接通过本地网络连接 Fronius Solar API v1——无需云账户或订阅，数据也不会离开你的家。

---

工作原理

fronius-mcp 是一个 Model Context Protocol (MCP) 服务。MCP 是一项开放标准，让 Claude 等 AI 助手能够连接外部工具和数据源。完成配置后，Claude 可以实时调用逆变器的本地 API——每当你询问太阳能系统相关问题时，Claude 都会获取实时数据，并根据当前的实际情况作答。

---

要求

• 本地网络中有一台已启用 Solar API（JSON API） 的 Fronius 逆变器
• Claude Desktop
• uv——快速的 Python 包管理器（一行命令即可安装）

---

设置

1. 安装 uv

uv 是一个快速的 Python 包管理器，用于运行 fronius-mcp，无需永久安装。

macOS / Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

irm https://astral.sh/uv/install.ps1 | iex

安装后重启终端。

2. 添加到 Claude Desktop

打开 claude_desktop_config.json，并在 mcpServers 中添加 fronius 配置块：

{
  "mcpServers": {
    "fronius": {
      "command": "uvx",
      "args": ["fronius-mcp"]
    }
  }
}

配置文件位置：

平台	路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Windows（Store 应用）	%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

提示： 如果 mcpServers 键已存在，只需在其中添加 fronius 配置块——不要再创建一个 mcpServers。

3. 重启 Claude Desktop

关闭并重新打开 Claude Desktop，使其加载新的服务配置。

4. 配置逆变器

在新的 Claude 对话中说：

“配置我的 Fronius 逆变器，IP 地址为 192.168.178.35”

Claude 会保存逆变器的 IP 并确认连接。这是一次性步骤——地址会存储在 ~/.fronius-mcp.json 中，并在重启后保留。

不知道逆变器的 IP？ 告诉 Claude：“我想配置我的 Fronius 逆变器，但不知道 IP 地址。” Claude 会指导你通过路由器、Fronius Solar.web 或逆变器的触摸屏查找 IP，并说明如何在逆变器的 Web 界面中启用 Solar API（如果你还没有启用）。

---

可以询问的内容

设置完成后，只需自然地与 Claude 对话。以下是一些示例：

• “我当前的太阳能输出是多少？” — 实时 PV 发电功率，单位为瓦
• “我现在的能源自给率有多高？” — 自给率和自用率百分比
• “我的电池正在充电还是放电？” — 电池功率流和电量状态
• “我今天向电网输送了多少电量？” — 智能电表的能源总量
• “有哪些设备连接到我的逆变器？” — 完整的系统拓扑
• “全面概述一下我的太阳能系统。” — Claude 会整合所有数据源并生成摘要

---

工具

工具	功能说明
configure_inverter	设置逆变器的 IP 地址——首次设置时运行一次
solar_power_flow	光伏发电量、电网交换功率、家庭负载、电池功率、自给率、能源总量
solar_meter	各相电网功率、累计输入／输出电量、电压、电流、频率
solar_battery	荷电状态、电压、电流、温度、容量、状态
solar_devices	所有已连接设备及其类型、总线索引和序列号

---

兼容硬件

开发并测试于：

• Fronius Symo GEN24 10.0 Plus
• BYD Battery-Box Premium HV（13.824 kWh）
• Fronius Smart Meter（电网馈电点，三相）

其他支持 Solar API v1 的 Fronius 逆变器应该也能使用。不同型号的某些 API 端点表现有所不同——如果你的硬件无法正常工作，请提交问题。

---

许可证

Apache 2.0——详见 LICENSE。