MeteoControl MCP-Server

Ein Model Context Protocol (MCP)-Server für die MeteoControl VCOM API v2. Diese Erweiterung ermöglicht es Ihnen, Solaranlagen zu überwachen, Energieerzeugungsdaten abzurufen und Systemzustandsprüfungen mittels natürlicher Sprache über die Gemini CLI durchzuführen.

Funktionen

• Systemerkennung: Auflistung aller mit Ihrem Konto verknüpften Solarsysteme.

• Energieüberwachung: Abruf historischer Energieerzeugungsdaten (Wh/kWh/MWh).

• Anlageninformationen: Technische Details zu Modulen, Wechselrichtern und Anlagenkapazität abrufen.

• Echtzeit-Leistung: Überprüfung der momentanen AC-Ausgangsleistung.

• Multi-Transport-Unterstützung: Lokal über Stdio ausführen oder remote über SSE hosten.

• Multi-Tenant (BYOC): Unterstützung für "Bring Your Own Credentials" in einer gemeinsam genutzten Umgebung.

Installation

Über Gemini CLI (Empfohlen)

Um die Erweiterung direkt von GitHub zu installieren:

gemini extensions add https://github.com/your-org/meteocontrol-mcp

Manuelle Installation

1. Klonen Sie das Repository:

   git clone https://github.com/your-org/meteocontrol-mcp.git
   cd meteocontrol-mcp

2. Installieren Sie die Abhängigkeiten und erstellen Sie den Build:

   npm install
   npm run build

Verwendung

Sobald die Installation abgeschlossen ist, können Sie Gemini nach Ihren Solarsystemen fragen:

• "List my solar systems."

• "What is the energy production for system [systemKey] for the last 24 hours?"

• "Show me the technical details for INV1 in system [systemKey]."

Multi-Tenant-Nutzung (BYOC)

Wenn Sie einen gemeinsam genutzten MCP-Server verwenden, können Sie Ihre eigenen Anmeldedaten direkt in Ihren Prompts angeben oder lokal konfigurieren. Die Tools akzeptieren optionale Argumente für apiKey, user und password.

Vorkonfigurierte Befehle

• /health [systemKey]: Führt eine umfassende Zustandsprüfung der Anlage durch.

• /yield [systemKey]: Ruft Energieerzeugungsdaten ab und fasst diese zusammen.

Bereitstellung & Hosting

Der Server unterstützt mehrere Betriebsmodi:

1. Lokaler Modus (Stdio)

Dies ist der Standardmodus, der von der Gemini CLI verwendet wird.

• Befehl: node dist/index.js

• Einrichtung: Definiert in gemini-extension.json unter Verwendung von command und args.

2. Remote-Modus (SSE)

Verwenden Sie diesen Modus, um den MCP-Server für mehrere Benutzer auf einem zentralen Server zu hosten.

Sicherheit: Generierung eines Zugriffstokens

Der Remote-Modus erfordert aus Sicherheitsgründen ein obligatorisches MCP_SERVER_TOKEN. Sie können ein sicheres Token wie folgt generieren:

openssl rand -base64 32

Serverkonfiguration

• Umgebungsvariablen:

  • MCP_TRANSPORT=sse

  • MCP_SERVER_TOKEN=your_generated_token (Erforderlich)

  • PORT=3000 (optional, Standardwert ist 3000)

• Ausführungsbefehl:

  MCP_TRANSPORT=sse MCP_SERVER_TOKEN=your_token node dist/index.js

3. Docker-Modus

Sie können den Server zur einfachen Bereitstellung als Container ausführen.

Für den Stdio-Modus (CLI-Nutzung):

docker run -i --rm \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

Für den SSE-Modus (Gehostete Nutzung):

docker run -d \
  -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e MCP_SERVER_TOKEN=your_token \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

Client-Konfiguration (für SSE)

Fügen Sie in Ihrer lokalen .gemini/settings.json die url und den Authorization-Header hinzu:

{
  "mcpServers": {
    "meteocontrol": {
      "url": "https://your-mcp-server.com/sse",
      "headers": {
        "Authorization": "Bearer your_generated_token"
      }
    }
  }
}

Konfiguration

Die folgenden Umgebungsvariablen sind erforderlich, damit der Server mit MeteoControl kommunizieren kann (sofern keine Anmeldedaten pro Anfrage bereitgestellt werden):

• METEOCONTROL_API_KEY: Ihr VCOM API-Schlüssel.

• METEOCONTROL_USER: Ihr VCOM-Benutzername (E-Mail).

• METEOCONTROL_PASSWORD: Ihr VCOM-Passwort.

Lizenz

Apache License 2.0