alpha-ess-mcp-server

michaelkrasa/alpha-ess-mcp-server

3.2

If you are the rightful owner of alpha-ess-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Alpha ESS MCP Server provides seamless access to Alpha ESS solar inverter and battery system data through the official Alpha ESS Open API, enabling AI assistants to monitor, analyze, and control energy storage systems.

Tools

  1. authenticate_alphaess

    Validates your Alpha ESS API credentials.

  2. get_ess_list

    Retrieves all Alpha ESS systems associated with your account.

  3. get_alpha_ess_data

    Gets comprehensive statistical energy data for analysis.

  4. get_last_power_data

    Retrieves real-time power data snapshot.

  5. get_one_day_power_data

    Gets detailed power data for a specific date.

  6. get_one_date_energy_data

    Retrieves comprehensive energy data for a specific date.

  7. get_charge_config

    Retrieves current battery charging configuration.

  8. get_discharge_config

    Gets current battery discharge configuration.

  9. set_battery_charge

    Configures battery charging schedule.

  10. set_battery_discharge

    Configures battery discharge schedule.

Alpha ESS MCP Server

smithery badge

A Model Context Protocol (MCP) server that provides access to Alpha ESS solar inverter and battery system data through the official Alpha ESS Open API.

Installation

uv sync

Configuration

Create a .env file in the project root:

ALPHA_ESS_APP_ID=your_app_id_here
ALPHA_ESS_APP_SECRET=your_app_secret_here

To get your Alpha ESS API credentials:

  1. Visit https://open.alphaess.com/
  2. Create a developer account
  3. Add your inverter system using the Serial Number (SN) and CheckCode
  4. Obtain your AppID and AppSecret

Usage with Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "alpha-ess": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "/path/to/alpha-ess-mcp-server/main.py"
      ],
      "env": {
        "ALPHA_ESS_APP_ID": "your_app_id_here",
        "ALPHA_ESS_APP_SECRET": "your_app_secret_here"
      }
    }
  }
}

Available Tools

Authentication & System Management

  • authenticate_alphaess() - Validate API credentials
  • get_ess_list() - List all registered Alpha ESS systems

Data Retrieval

  • get_alpha_ess_data() - Get comprehensive energy statistics for all systems
  • get_last_power_data(serial?) - Get real-time power data snapshot
  • get_one_day_power_data(query_date, serial?) - Get detailed power data for a specific date
  • get_one_date_energy_data(query_date, serial?) - Get energy summary for a specific date

Battery Configuration

  • get_charge_config(serial?) - Get current battery charging configuration
  • get_discharge_config(serial?) - Get current battery discharge configuration
  • set_battery_charge(enabled, dp1_start, dp1_end, dp2_start, dp2_end, charge_cutoff_soc, serial?) - Configure battery charging schedule
  • set_battery_discharge(enabled, dp1_start, dp1_end, dp2_start, dp2_end, discharge_cutoff_soc, serial?) - Configure battery discharge schedule

Parameters

  • serial (optional) - System serial number. If not provided, automatically selects the first system if only one exists
  • query_date - Date in YYYY-MM-DD format
  • enabled - Boolean to enable/disable the configuration
  • dp1_start/dp1_end, dp2_start/dp2_end - Time periods in HH:MM format (minutes must be :00, :15, :30, :45)
  • charge_cutoff_soc/discharge_cutoff_soc - SOC percentage (0-100)

Testing

uv run python test_methods.py

License

MIT License

References