1. Conduid
  2. Blockchain
  3. Alpha ESS Solar Energy System Server
MCP server · Blockchain

Alpha ESS Solar Energy System Server

by · github.com/michaelkrasa/alpha-ess-mcp-server

Provide seamless access to Alpha ESS solar inverter and battery system data for AI assistants. Monitor real-time and historical energy statistics, configure battery charge and discharge schedules, and analyze energy trends with structured, enhanced data responses. Enable intelligent energy management and system control through secure API integration.

Unclaimed last commit 10 months ago blockchain
InstallView source
34Low

Scored 6 months ago · breakdown

About Alpha ESS Solar Energy System Server

Alpha ESS Solar Energy System Server is an MCP server published by michaelkrasa in the Blockchain category: provide seamless access to Alpha ESS solar inverter and battery system data for AI assistants. Monitor real-time and historical energy statistics, configure battery charge and discharge schedules, and analyze energy trends with structured, enhanced data responses. Enable intelligent energy management and system control through secure API integration.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/michaelkrasa/alpha-ess-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Alpha ESS Solar Energy System Server

Powered by Claude · Grounded in docs

I know everything about Alpha ESS Solar Energy System Server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Alpha ESS Solar Energy System Server

How do I install Alpha ESS Solar Energy System Server?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Alpha ESS Solar Energy System Server safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Alpha ESS Solar Energy System Server still maintained?

The last commit was 10 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.