⚡ eskomsepush-mcp

EskomSePush를 위한 Model Context Protocol 서버 — 실시간 남아프리카 공화국 부하 차단 데이터를 Claude 및 모든 MCP 호환 AI 클라이언트에 제공합니다.

남아프리카 공화국 개발자가 남아프리카 공화국 사람들을 위해 만들었습니다. Claude에게 일상적인 언어로 부하 차단에 대해 물어보세요.

기능

예시 프롬프트

• "지금 몇 단계인가요?" → 무료 플랜에서 작동

• "오늘 API 호출이 얼마나 남았나요?" → 무료 플랜에서 작동

• "오늘 밤 Stellenbosch에 부하 차단이 있나요?" → 유료 플랜

• "이번 주 Sandton의 부하 차단 일정을 보여줘" → 유료 플랜

• "내 근처의 부하 차단 지역 찾기" (GPS 사용) → 유료 플랜

사전 요구 사항

• Node.js 18+ 버전

• eskomsepush.gumroad.com/l/api에서 발급받은 EskomSePush API 토큰

API 플랜 요구 사항

EskomSePush는 계층형 API를 운영합니다. 무료 티어는 지역 조회 엔드포인트에서 HTTP 410 Gone을 반환하며, 해당 기능은 유료 구독이 필요합니다. 이 MCP 서버는 플랜에 관계없이 전체 도구 인터페이스를 노출하며, 지원되지 않는 도구는 클라이언트에 410 오류를 명확하게 표시합니다.

설치

옵션 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를 전달하면 모의 데이터를 반환하며 일일 할당량에 포함되지 않습니다.

테스트 상태

유료 플랜을 사용 중이며 유료 티어 도구를 테스트하신다면, 동작 확인을 위해 이슈나 PR을 열어주시기 바랍니다.

API 할당량

check_allowance 도구를 사용하여 사용량을 모니터링하세요. 빌드 중에는 test: true를 사용하세요.

기여

PR을 환영합니다. 남아프리카 공화국 거주자로서 더 유용하게 만들 아이디어가 있다면 이슈를 열어주세요.

ZATech Slack의 #eskomsepush 채널에서 EskomSePush 개발자 커뮤니티에 참여하세요.

라이선스

MIT © Zukanye Ndiki