⚡ eskomsepush-mcp

EskomSePush 用のModel Context Protocolサーバー — 南アフリカのリアルタイムな計画停電データをClaudeやMCP対応のAIクライアントで利用可能にします。

南アフリカの開発者が、南アフリカ人のために作成しました。Claudeに計画停電について自然な言葉で質問できます。

機能

プロンプト例

• "What stage are we on right now?"（現在どのステージですか？） → 無料プランで動作

• "How many API calls do I have left today?"（今日の残りAPIコール数は？） → 無料プランで動作

• "Is there load shedding in Stellenbosch tonight?"（今夜ステレンボッシュで計画停電はありますか？） → 有料プラン

• "Show me the load shedding schedule for Sandton this week"（今週のサントンでの計画停電スケジュールを見せて） → 有料プラン

• "Find load shedding areas near me"（近くの計画停電エリアを探して）（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 を任意のツールに渡すと、モックデータが返され、1日のクォータを消費しません。

テスト状況

有料プランをご利用で、有料ティアのツールをテストされた場合は、動作確認のためにIssueやPRを作成してください。

APIクォータ

check_allowance ツールを使用して使用状況を監視してください。開発中は test: true を使用してください。

貢献

PRを歓迎します。南アフリカの方で、より便利にするためのアイデアがあればIssueを作成してください。

ZATech Slack の #eskomsepush でEskomSePush開発者コミュニティに参加してください。

ライセンス

MIT © Zukanye Ndiki