{
  "markdown": "# fronius-mcp\n<!-- mcp-name: io.github.flowiesner/fronius-mcp -->\n\n[![PyPI](https://img.shields.io/pypi/v/fronius-mcp)](https://pypi.org/project/fronius-mcp/)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)\n\nReal-time solar data from your Fronius inverter, directly in Claude.\n\nAsk things like:\n\n> *\"How much solar power am I generating right now?\"*\n>\n> *\"What's my battery charge level?\"*\n>\n> *\"Am I currently importing or exporting to the grid?\"*\n>\n> *\"How much energy did I produce this year?\"*\n>\n> *\"What can you do with my solar system?\"*\n>\n> *\"Analyse my photovoltaics for me.\"*\n\nConnects to the **Fronius Solar API v1** directly on your local network — no cloud account, no subscription, no data leaving your home.\n\n---\n\n## How it works\n\nfronius-mcp is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server. MCP is an open standard that lets AI assistants like Claude connect to external tools and data sources. Once configured, Claude can call your inverter's local API in real time — whenever you ask a question about your solar system, Claude fetches live data and answers based on what's actually happening right now.\n\n---\n\n## Requirements\n\n- A Fronius inverter on your local network with the **Solar API (JSON API) enabled**\n- [Claude Desktop](https://claude.ai/download)\n- [`uv`](https://docs.astral.sh/uv/getting-started/installation/) — a fast Python package manager (one-line install)\n\n---\n\n## Setup\n\n### 1. Install uv\n\n`uv` is a fast Python package manager used to run fronius-mcp without a permanent install.\n\n**macOS / Linux:**\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https://astral.sh/uv/install.ps1 | iex\n```\n\nRestart your terminal after installing.\n\n### 2. Add to Claude Desktop\n\nOpen your `claude_desktop_config.json` and add the `fronius` block inside `mcpServers`:\n\n```json\n{\n  \"mcpServers\": {\n    \"fronius\": {\n      \"command\": \"uvx\",\n      \"args\": [\"fronius-mcp\"]\n    }\n  }\n}\n```\n\n**Config file location:**\n\n| Platform | Path |\n|---|---|\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Windows (Store app) | `%LOCALAPPDATA%\\Packages\\Claude_pzs8sxrjxfjjc\\LocalCache\\Roaming\\Claude\\claude_desktop_config.json` |\n\n> **Tip:** If the `mcpServers` key already exists, just add the `fronius` block inside it — don't create a second `mcpServers`.\n\n### 3. Restart Claude Desktop\n\nClose and reopen Claude Desktop so it picks up the new server config.\n\n### 4. Configure your inverter\n\nIn a new Claude conversation, say:\n\n> *\"Configure my Fronius inverter at 192.168.178.35\"*\n\nClaude will save your inverter's IP and confirm the connection. This is a one-time step — the address is stored in `~/.fronius-mcp.json` and persists across restarts.\n\n**Don't know your inverter's IP?** Tell Claude: *\"I want to configure my Fronius inverter but I don't know the IP.\"* Claude will walk you through finding it via your router, Fronius Solar.web, or the inverter's touch display — and how to enable the Solar API in the inverter's web interface if you haven't done that yet.\n\n---\n\n## What you can ask\n\nOnce set up, just talk to Claude naturally. Some examples:\n\n- *\"What's my current solar output?\"* — live PV generation in watts\n- *\"How self-sufficient am I right now?\"* — autonomy and self-consumption percentages\n- *\"Is my battery charging or discharging?\"* — battery power flow and state of charge\n- *\"How much have I fed into the grid today?\"* — energy totals from the smart meter\n- *\"What devices are connected to my inverter?\"* — full system topology\n- *\"Give me a full overview of my solar system.\"* — Claude combines all data sources into a summary\n\n---\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `configure_inverter` | Set your inverter's IP address — run this once on first setup |\n| `solar_power_flow` | PV generation, grid exchange, house load, battery power, autonomy, energy totals |\n| `solar_meter` | Grid power per phase, cumulative energy in/out, voltage, current, frequency |\n| `solar_battery` | State of charge, voltage, current, temperature, capacity, status |\n| `solar_devices` | All connected devices with type, bus index, and serial number |\n\n---\n\n## Compatible Hardware\n\nDeveloped and tested on:\n\n- **Fronius Symo GEN24 10.0 Plus**\n- **BYD Battery-Box Premium HV** (13.824 kWh)\n- **Fronius Smart Meter** (grid feed-in point, 3-phase)\n\nOther Fronius inverters with Solar API v1 support should work. Some API endpoints behave differently across models — if something doesn't work on your hardware, open an issue.\n\n---\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE).\n",
  "bytes": 4736,
  "sha": "e7d83788c1203dda1dbc89fdf82e0e2cbb0f1c7cd8f42c784e7a276a1a2b7a8d",
  "repo_slug": "flowiesner/fronius-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_flowiesner_fronius_mcp_92caede0/readme"
}