Solplanet MCP

Een Model Context Protocol (MCP) server voor de Solplanet ASW5-T omvormer (en compatibele modellen). Hiermee kun je Claude vragen stellen over je zonne-energie systeem in gewone taal.

Voorbeeld: "Hoeveel heeft mijn omvormer vandaag geproduceerd?" of "Zet de accu op zelfverbruikmodus."

Vereisten

• Python 3.10 of hoger

• Claude Desktop

• Solplanet omvormer met Wi-Fi stick, bereikbaar op je lokale netwerk

Related MCP server: MeteoControl MCP Server

Installatie

1. Bestanden downloaden

Clone of download deze repository:

git clone https://github.com/kalmma/solplanet-mcp.git
cd solplanet-mcp

2. Python dependencies installeren

pip install -r requirements.txt

3. Setup uitvoeren

Voer het setup-script éénmalig uit. Het vraagt het IP-adres van je omvormer, test de verbinding en slaat de configuratie op.

python3 setup_solplanet.py

Het IP-adres van je omvormer vind je in je router (verbonden apparaten) of in de Solplanet app onder apparaatinformatie.

4. Claude Desktop configureren

Voeg de MCP server toe aan je Claude Desktop configuratie. Het configuratiebestand staat op:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Voeg het volgende toe (pas het pad aan naar waar je solplanet_mcp.py hebt opgeslagen):

{
  "mcpServers": {
    "solplanet": {
      "command": "python3",
      "args": ["/absoluut/pad/naar/solplanet_mcp.py"]
    }
  }
}

Zie claude_desktop_config.example.json voor een voorbeeldbestand.

5. Claude Desktop herstarten

Herstart Claude Desktop. De Solplanet MCP is nu actief.

Beschikbare tools

Voorbeeldvragen aan Claude

• "Wat is het huidige zonnepanelenvermogen?"

• "Hoeveel energie heb ik vandaag geproduceerd?"

• "Koop ik nu stroom in of lever ik terug?"

• "Wat is de laadstatus van mijn accu?"

• "Zet de accu op tijdgebaseerd laden."

• "Stel het minimale accuniveau in op 15%."

• "Wat is het laadschema van de accu deze week?"

Technische achtergrond

De omvormer communiceert via HTTP op poort 8484. De volgende endpoints worden gebruikt:

Deze MCP is gebaseerd op de Home Assistant Solplanet integratie door Zbigniew Motyka.

Configuratie via omgevingsvariabele

In plaats van het setup-script kun je ook een omgevingsvariabele gebruiken:

SOLPLANET_HOST=192.168.1.100 python3 solplanet_mcp.py

Of in de Claude Desktop config:

{
  "mcpServers": {
    "solplanet": {
      "command": "python3",
      "args": ["/pad/naar/solplanet_mcp.py"],
      "env": {
        "SOLPLANET_HOST": "192.168.1.100"
      }
    }
  }
}

Compatibiliteit

Getest met de Solplanet ASW5-T. Waarschijnlijk ook compatibel met andere Solplanet/AISWEI omvormers die de Wi-Fi stick gebruiken. Accusysteemtools vereisen een gekoppeld batterijsysteem.

Licentie

MIT