⚡ eskomsepush-mcp

Model Context Protocol-Server für EskomSePush — bringt Echtzeit-Daten zu südafrikanischen Lastabwürfen (Load Shedding) zu Claude und jedem MCP-kompatiblen KI-Client.

Von einem südafrikanischen Entwickler für Südafrikaner gebaut. Fragen Sie Claude in natürlicher Sprache nach Lastabwürfen.

Was es tut

Beispiel-Prompts

• "Auf welcher Stufe sind wir gerade?" → funktioniert mit dem kostenlosen Plan

• "Wie viele API-Aufrufe habe ich heute noch übrig?" → funktioniert mit dem kostenlosen Plan

• "Gibt es heute Abend in Stellenbosch Lastabwürfe?" → kostenpflichtiger Plan

• "Zeig mir den Lastabwurf-Zeitplan für Sandton diese Woche" → kostenpflichtiger Plan

• "Finde Lastabwurf-Gebiete in meiner Nähe" (mit GPS) → kostenpflichtiger Plan

Voraussetzungen

• Node.js 18+

• Ein EskomSePush-API-Token von eskomsepush.gumroad.com/l/api

Anforderungen an den API-Plan

EskomSePush betreibt eine gestaffelte API. Die kostenlose Stufe gibt bei Gebiets-Such-Endpunkten den Fehler HTTP 410 Gone zurück — diese erfordern ein kostenpflichtiges Abonnement. Dieser MCP-Server stellt die gesamte Tool-Oberfläche unabhängig vom Plan bereit; nicht unterstützte Tools geben den Fehler 410 als klare Fehlermeldung an den Client weiter.

Installation

Option 1 — npx (empfohlen)

npx eskomsepush-mcp

Option 2 — Klonen & bauen

git clone https://github.com/zukhanyendiki9-code/eskomsepush-mcp.git
cd eskomsepush-mcp
npm install
npm run build

Konfiguration

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "eskomsepush": {
      "command": "npx",
      "args": ["-y", "eskomsepush-mcp"],
      "env": {
        "ESP_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Code

claude mcp add eskomsepush -e ESP_API_TOKEN=your-token -- npx -y eskomsepush-mcp

Cursor / Windsurf

{
  "mcpServers": {
    "eskomsepush": {
      "command": "npx",
      "args": ["-y", "eskomsepush-mcp"],
      "env": {
        "ESP_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Entwicklung

npm run build        # compile TypeScript
npm run dev          # watch mode
npm run inspect      # open MCP Inspector UI for testing

Tipp: Übergeben Sie test: true an ein beliebiges Tool während der Entwicklung — es gibt Mock-Daten zurück und zählt nicht gegen Ihr tägliches Kontingent.

Teststatus

Wenn Sie einen kostenpflichtigen Plan haben und eines der Tools der kostenpflichtigen Stufe testen, eröffnen Sie bitte ein Issue oder einen PR, um das Verhalten zu bestätigen.

API-Kontingent

Verwenden Sie das Tool check_allowance, um Ihre Nutzung zu überwachen. Verwenden Sie test: true während der Entwicklung.

Mitwirken

PRs sind willkommen. Wenn Sie Südafrikaner sind und Ideen haben, wie man dies nützlicher gestalten kann, eröffnen Sie ein Issue.

Treten Sie der EskomSePush-Entwickler-Community auf ZATech Slack im Kanal #eskomsepush bei.

Lizenz

MIT © Zukanye Ndiki