AI导哈

能源账户MCP服务器

这是一个为AI助手提供Salt River Project能源账户数据访问能力的MCP服务器，支持账单信息、用电量、付款记录和停电状态查询。

  • by architagrawal
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 architagrawal/srp-electric-mcp

使用说明

SRP Energy MCP Server

A Python MCP server (Model Context Protocol, the standard way to give AI agents tools) for the Salt River Project energy portal. It signs in to your SRP account and gives an assistant like Claude 7 tools and 4 analysis prompts for billing, usage, payments and outages.

Quick Start (One-Click Setup)

We provide a user-friendly setup wizard to get you started in seconds.

  1. Configure Credentials: Double-click Setup.bat. This will open a browser window where you can securely log in to your SRP account.

  2. Start the Server: Double-click Start.bat.

That's it! Your server is now running and ready to accept requests.

Data Analysis & Features

  • Hourly & Daily Usage: Retrieve detailed energy consumption data.
  • Billing Info: Get current balance, bill projection, and rate plan details.
  • Payments: View payment history and scheduled payments.
  • Outages: Check for active outages and view outage history.
  • Documents: List available eBills.
  • Universal Access: Execute raw API requests against any SRP endpoint.

Setup

1. Installation

Clone the repository and install dependencies:

pip install -r requirements.txt

Note: Requires mcp and httpx libraries.

2. Configuration (Environment Variables)

To keep your credentials safe, this server uses environment variables. Do not hardcode your password in the source code.

Create a .env file in the project root:

SRP_USERNAME=your_email@example.com
SRP_PASSWORD=your_srp_password
SRP_ACCOUNT_ID=1234567890

3. Usage with Claude Desktop (or other MCP Clients)

Add the server to your MCP client configuration (e.g., claude_desktop_config.json). Pass the credentials via env:

{
  "mcpServers": {
    "srp-energy": {
      "command": "python",
      "args": ["/path/to/SRP/src/srp/server.py"],
      "env": {
        "SRP_USERNAME": "your_email@example.com",
        "SRP_PASSWORD": "your_srp_password",
        "SRP_ACCOUNT_ID": "1234567890"
      }
    }
  }
}

Tools

Tool Name Description
get_billing_info Balance, rate plan, and bill projection.
get_payment_history Past and scheduled payments.
get_energy_usage Hourly energy usage for a date range.
get_daily_energy_usage Daily energy usage for a date range.
get_outages Active outages and history.
get_user_profile Account holder details.
request_srp_api Raw access to any SRP API endpoint.

Verification

You can use the built-in demo script to test your connection:

python demo_client.py

Work with me

I am open to full-time roles building AI agents, integrations and data platforms. LinkedIn, portfolio.

If this tool is useful, a star helps others find it.

Credits

Developed by Archit

If you have questions, feedback, or just want to connect, feel free to reach out!

  • GitHub: github.com/architagrawal

Built with ❤️ using the Model Context Protocol (MCP).

相关 MCP