⚡ eskomsepush-mcp

EskomSePush 的模型上下文协议 (MCP) 服务器 — 为 Claude 和任何兼容 MCP 的 AI 客户端带来南非实时限电数据。

由南非开发者为南非人打造。用通俗语言向 Claude 询问限电情况。

功能介绍

示例提示词

• “我们现在处于哪个阶段？” → 适用于免费计划

• “我今天还剩多少次 API 调用？” → 适用于免费计划

• “斯泰伦博斯今晚有限电吗？” → 适用于付费计划

• “向我展示桑顿本周的限电时间表” → 适用于付费计划

• “查找我附近的限电区域” (使用 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 — 它会返回模拟数据，且不会计入您的每日配额。

测试状态

如果您使用的是付费计划并测试了任何付费层级工具，请提交 issue 或 PR 以确认其行为。

API 配额

使用 check_allowance 工具监控您的使用情况。在构建时使用 test: true。

贡献

欢迎提交 PR。如果您是南非人，并且有让此工具更有用的想法，请提交 issue。

加入 ZATech Slack 中的 #eskomsepush 频道，参与 EskomSePush 开发者社区。

许可证

MIT © Zukanye Ndiki