mcpField
A
Alpha Ess Solar Energy System Server

Alpha Ess Solar Energy System Server

Local
github.com/michaelkrasaOther0Updated 46w ago
Repository

About Alpha Ess Solar Energy System Server

An MCP server that connects to Alpha ESS solar inverter and battery data through the official Open API. It is for users monitoring energy systems or managing battery schedules, with tools for live and historical data as well as charge and discharge settings.

Key features

  1. 01List registered Alpha ESS systems
  2. 02Retrieve real-time power snapshots
  3. 03Query daily power and energy data
  4. 04Read battery charge and discharge settings
  5. 05Set battery charge and discharge schedules

Use cases

  1. 01Check current solar and battery output
  2. 02Review energy data for a selected date
  3. 03Adjust battery charging or discharging periods

MCP support

Exposes Alpha ESS system data and battery configuration tools to MCP clients through the official Alpha ESS Open API.

#alphaess#solar#inverter#battery#battery-storage

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.