Alpha Ess Solar Energy System Server

Alpha ESS MCP サーバー

公式の Alpha ESS Open API を通じて、Alpha ESS の太陽光インバーターおよび蓄電池システムのデータにアクセスできる Model Context Protocol（MCP）サーバーです。

インストール

uv sync

設定

プロジェクトのルートに .env ファイルを作成します。

ALPHA_ESS_APP_ID=your_app_id_here
ALPHA_ESS_APP_SECRET=your_app_secret_here

Alpha ESS API の認証情報を取得するには、次の手順に従います。

1. https://open.alphaess.com/ にアクセスします
2. 開発者アカウントを作成します
3. シリアル番号（SN）と CheckCode を使ってインバーターシステムを追加します
4. AppID と AppSecret を取得します

Claude Desktop での使用

Claude Desktop の設定ファイルに追加します。

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"
      }
    }
  }
}

利用可能なツール

認証とシステム管理

• authenticate_alphaess() - API 認証情報を検証します
• get_ess_list() - 登録済みの Alpha ESS システムをすべて一覧表示します

データの取得

• get_alpha_ess_data() - すべてのシステムの包括的なエネルギー統計を取得します
• get_last_power_data(serial?) - リアルタイムの電力データスナップショットを取得します
• get_one_day_power_data(query_date, serial?) - 指定した日付の詳細な電力データを取得します
• get_one_date_energy_data(query_date, serial?) - 指定した日付のエネルギー概要を取得します

蓄電池の設定

• get_charge_config(serial?) - 現在の蓄電池充電設定を取得します
• get_discharge_config(serial?) - 現在の蓄電池放電設定を取得します
• set_battery_charge(enabled, dp1_start, dp1_end, dp2_start, dp2_end, charge_cutoff_soc, serial?) - 蓄電池の充電スケジュールを設定します
• set_battery_discharge(enabled, dp1_start, dp1_end, dp2_start, dp2_end, discharge_cutoff_soc, serial?) - 蓄電池の放電スケジュールを設定します

パラメーター

• serial（省略可）- システムのシリアル番号です。指定しない場合、システムが1つだけなら自動的にそのシステムが選択されます
• query_date - YYYY-MM-DD 形式の日付です
• enabled - 設定を有効または無効にするブール値です
• dp1_start/dp1_end, dp2_start/dp2_end - HH:MM 形式の時間帯です（分は :00、:15、:30、:45 のいずれかにしてください）
• charge_cutoff_soc/discharge_cutoff_soc - SOC の割合（0～100）です

テスト

uv run python test_methods.py

ライセンス

MIT ライセンス

参考資料

• Alpha ESS Open API ドキュメント
• alphaess-openAPI ライブラリ
• Model Context Protocol