Alpha Ess Solar Energy System Server
@michaelkrasa
About Alpha Ess Solar Energy System 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 intellig
Config
Add this server to your MCP-compatible client using the configuration below.
{
"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"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Alpha Ess Solar Energy System Server?
An MCP server that provides access to Alpha ESS solar inverter and battery system data through the official Alpha ESS Open API. It is designed for developers and system administrators who want to monitor and control their Alpha ESS energy storage systems programmatically.
How to use Alpha Ess Solar Energy System Server?
Install with uv sync, create a .env file containing your Alpha ESS API credentials (AppID and AppSecret), then add the server to your MCP client configuration (e.g., Claude Desktop) using uv run python /path/to/main.py. Once configured, you can call the provided tools to retrieve live and historical energy data, list systems, and modify battery charge/discharge settings.
Key features of Alpha Ess Solar Energy System Server
- Authenticate with Alpha ESS Open API credentials
- List all registered Alpha ESS systems
- Retrieve comprehensive energy statistics for all systems
- Get real-time and historical power data snapshots
- Configure battery charging and discharge schedules
Use cases of Alpha Ess Solar Energy System Server
- Monitor real-time solar production and battery status via an AI assistant
- Automate battery charging/discharge schedules based on time-of-use tariffs
- Retrieve daily or date-specific energy summaries for reporting
- Validate API credentials and check system connectivity without a web interface
FAQ from Alpha Ess Solar Energy System Server
How do I obtain Alpha ESS API credentials?
Visit https://open.alphaess.com/, create a developer account, add your inverter system using the Serial Number and CheckCode, then obtain your AppID and AppSecret.
What if I have multiple Alpha ESS systems?
The serial parameter is optional on most tools. If omitted and only one system is registered, the server automatically uses it. For multiple systems, you must provide the serial number.
What time formats are required for battery scheduling?
Period start/end times (e.g., dp1_start, dp1_end) must be in HH:MM format where minutes are restricted to :00, :15, :30, or :45. The charge/discharge cutoff state of charge is an integer percentage from 0 to 100.
What runtime dependencies does this server require?
The server runs on Python with the uv package manager. It uses the Alpha ESS Open API, which requires a valid AppID and AppSecret. No additional hardware or local data storage is needed.
How does authentication work?
The server authenticates via the Alpha ESS Open API using the provided AppID and AppSecret stored in a .env file. Credentials are validated by calling the authenticate_alphaess() tool.
Frequently asked questions
How do I obtain Alpha ESS API credentials?
Visit [https://open.alphaess.com/](https://open.alphaess.com/), create a developer account, add your inverter system using the Serial Number and CheckCode, then obtain your AppID and AppSecret.
What if I have multiple Alpha ESS systems?
The `serial` parameter is optional on most tools. If omitted and only one system is registered, the server automatically uses it. For multiple systems, you must provide the serial number.
What time formats are required for battery scheduling?
Period start/end times (e.g., `dp1_start`, `dp1_end`) must be in `HH:MM` format where minutes are restricted to `:00`, `:15`, `:30`, or `:45`. The charge/discharge cutoff state of charge is an integer percentage from 0 to 100.
What runtime dependencies does this server require?
The server runs on Python with the `uv` package manager. It uses the Alpha ESS Open API, which requires a valid AppID and AppSecret. No additional hardware or local data storage is needed.
How does authentication work?
The server authenticates via the Alpha ESS Open API using the provided AppID and AppSecret stored in a `.env` file. Credentials are validated by calling the `authenticate_alphaess()` tool.
Basic information
More Other MCP servers
Blender
ahujasidOpen-source MCP to use Blender with any LLM
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
Codelf
unbugA search tool helps dev to solve the naming things problem.
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Comments