⚡ eskomsepush-mcp

Сервер Model Context Protocol для EskomSePush — предоставляет данные о веерных отключениях электроэнергии в Южной Африке в реальном времени для Claude и любого MCP-совместимого ИИ-клиента.

Создано южноафриканским разработчиком для жителей Южной Африки. Спрашивайте у Claude об отключениях электроэнергии на обычном языке.

Что он делает

Инструмент	Описание	План
`get_status`	Текущая национальная стадия отключений (Eskom + Кейптаун)	Бесплатно ✅
`check_allowance`	Проверка оставшегося количества вызовов API на сегодня	Бесплатно ✅
`search_areas`	Поиск ID вашего района по названию пригорода или города	Платно 💳
`get_area_schedule`	Предстоящие события и полное расписание для вашего района	Платно 💳
`get_areas_nearby`	Поиск районов по GPS-координатам	Платно 💳

Примеры запросов

"Какая сейчас стадия отключений?" → работает на бесплатном плане
"Сколько вызовов API у меня осталось на сегодня?" → работает на бесплатном плане
"Будут ли отключения в Стелленбосе сегодня вечером?" → платный план
"Покажи расписание отключений для Сэндтона на эту неделю" → платный план
"Найди районы с отключениями рядом со мной" (с GPS) → платный план

Предварительные требования

Node.js 18+
API-токен EskomSePush с сайта eskomsepush.gumroad.com/l/api

Требования к API-плану

EskomSePush использует многоуровневую систему API. Бесплатный уровень возвращает HTTP 410 Gone для эндпоинтов поиска районов — для них требуется платная подписка. Этот MCP-сервер предоставляет полный набор инструментов независимо от плана; неподдерживаемые инструменты будут возвращать ошибку 410, понятную для клиента.

План	Стоимость	Что работает
Бесплатный	$0 через Gumroad	`get_status`, `check_allowance`
Платный	От $55/год	Все 5 инструментов

Установка

Вариант 1 — npx (рекомендуется)

npx eskomsepush-mcp

Вариант 2 — Клонирование и сборка

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

Конфигурация

Claude Desktop

Добавьте в ваш 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"
      }
    }
  }
}

Разработка

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

Совет: Передавайте test: true любому инструменту во время разработки — он вернет фиктивные данные и не будет учитываться в вашей дневной квоте.

Статус тестирования

Инструмент	Протестировано на бесплатном плане
`get_status`	✅
`check_allowance`	✅
`search_areas`	⚠️ Требуется платный план
`get_area_schedule`	⚠️ Требуется платный план
`get_areas_nearby`	⚠️ Требуется платный план

Если у вас платный план и вы тестируете любой из платных инструментов, пожалуйста, откройте issue или PR, чтобы подтвердить поведение.

Квота API

План	Вызовов/день
Бесплатный	50
Платный	Более высокие лимиты

Используйте инструмент check_allowance для мониторинга использования. Используйте test: true во время разработки.

Участие в разработке

PR приветствуются. Если вы из Южной Африки и у вас есть идеи, как сделать это полезнее, откройте issue.

Присоединяйтесь к сообществу разработчиков EskomSePush в ZATech Slack в канале #eskomsepush.

eskomsepush-mcp