⚡ eskomsepush-mcp

Servidor del Protocolo de Contexto de Modelo (MCP) para EskomSePush: lleva los datos en tiempo real sobre los cortes de energía en Sudáfrica a Claude y a cualquier cliente de IA compatible con MCP.

Creado por un desarrollador sudafricano, para sudafricanos. Pregúntale a Claude sobre los cortes de energía en lenguaje sencillo.

Qué hace

Ejemplos de prompts

• "¿En qué etapa estamos ahora mismo?" → funciona en el plan gratuito

• "¿Cuántas llamadas a la API me quedan hoy?" → funciona en el plan gratuito

• "¿Hay cortes de energía en Stellenbosch esta noche?" → plan de pago

• "Muéstrame el horario de cortes de energía para Sandton esta semana" → plan de pago

• "Encuentra áreas con cortes de energía cerca de mí" (con GPS) → plan de pago

Requisitos previos

• Node.js 18+

• Un token de API de EskomSePush de eskomsepush.gumroad.com/l/api

Requisitos del plan de API

EskomSePush opera con una API por niveles. El nivel gratuito devuelve HTTP 410 Gone en los endpoints de búsqueda de áreas; estos requieren una suscripción de pago. Este servidor MCP expone toda la superficie de herramientas independientemente del plan; las herramientas no compatibles mostrarán el error 410 como un error claro para el cliente.

Instalación

Opción 1 — npx (recomendado)

npx eskomsepush-mcp

Opción 2 — Clonar y compilar

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

Configuración

Claude Desktop

Añadir a tu claude_desktop_config.json:

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"
      }
    }
  }
}

Desarrollo

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

Consejo: Pasa test: true a cualquier herramienta durante el desarrollo; devuelve datos simulados y no cuenta para tu cuota diaria.

Estado de las pruebas

Si tienes un plan de pago y pruebas alguna de las herramientas del nivel de pago, por favor abre un issue o un PR para confirmar el comportamiento.

Cuota de API

Usa la herramienta check_allowance para monitorear tu uso. Usa test: true mientras desarrollas.

Contribuciones

Los PR son bienvenidos. Si eres sudafricano y tienes ideas para hacerlo más útil, abre un issue.

Únete a la comunidad de desarrolladores de EskomSePush en ZATech Slack en #eskomsepush.

Licencia

MIT © Zukanye Ndiki