プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Aivy Energy

作者:IVYEnergyバージョン 0.9.2i★ 2iパソコンで動く公式サイト ↗
レジストリ名io.github.IVYEnergy/aivy-mcp

インストール方法

What it does

Read and control your own home solar + battery: Sungrow, Sigenergy, FoxESS, AlphaESS, SolaX.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気30/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア42/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Aivy Energy をインストールして。https://mcp.popnx.com/i/ivyenergy-aivy-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Aivy Energy を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "aivy": { "command": "uvx", "args": [ "aivy-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Aivy Energy のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "aivy": {
          "command": "uvx",
          "args": [
            "aivy-mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Aivy Energy を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Aivy Energy を使っていると言うか、回答に Aivy Energy のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • AIVY_API_KEY 個人用 Aivy API キー(aivy_sk_...)。任意です。設定しない場合、register_account または sign_in がチャットからキーを作成して保存します。
    英語の原文を見るPersonal Aivy API key (aivy_sk_...). Optional: without one, register_account or sign_in creates and stores a key from the chat.
  • AIVY_API_URL API のベース URL。デフォルトは https://bridge.ivyenergy.com.au/v1
    英語の原文を見るAPI base URL. Default https://bridge.ivyenergy.com.au/v1
    · 初期値 https://bridge.ivyenergy.com.au/v1

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Aivy Energy につなげません

Aivy Energy はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Aivy Energy につなげるアプリを使う

  • 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Aivy Energy を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user aivy -- uvx aivy-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Aivy Energy のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user aivy -- uvx aivy-mcp
  4. Claude Code で /mcp と入力

    Aivy Energy が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Aivy Energy を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Aivy Energy を使っていると言うか、回答に Aivy Energy のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • AIVY_API_KEY 個人用 Aivy API キー(aivy_sk_...)。任意です。設定しない場合、register_account または sign_in がチャットからキーを作成して保存します。
    英語の原文を見るPersonal Aivy API key (aivy_sk_...). Optional: without one, register_account or sign_in creates and stores a key from the chat.
  • AIVY_API_URL API のベース URL。デフォルトは https://bridge.ivyenergy.com.au/v1
    英語の原文を見るAPI base URL. Default https://bridge.ivyenergy.com.au/v1
    · 初期値 https://bridge.ivyenergy.com.au/v1

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Aivy Energy を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "aivy": { "command": "uvx", "args": [ "aivy-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Aivy Energy のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Aivy Energy を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Aivy Energy を使っていると言うか、回答に Aivy Energy のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • AIVY_API_KEY 個人用 Aivy API キー(aivy_sk_...)。任意です。設定しない場合、register_account または sign_in がチャットからキーを作成して保存します。
    英語の原文を見るPersonal Aivy API key (aivy_sk_...). Optional: without one, register_account or sign_in creates and stores a key from the chat.
  • AIVY_API_URL API のベース URL。デフォルトは https://bridge.ivyenergy.com.au/v1
    英語の原文を見るAPI base URL. Default https://bridge.ivyenergy.com.au/v1
    · 初期値 https://bridge.ivyenergy.com.au/v1

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Aivy Energy を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "aivy": { "type": "stdio", "command": "uvx", "args": [ "aivy-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Aivy Energy のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Aivy Energy を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Aivy Energy を使っていると言うか、回答に Aivy Energy のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • AIVY_API_KEY 個人用 Aivy API キー(aivy_sk_...)。任意です。設定しない場合、register_account または sign_in がチャットからキーを作成して保存します。
    英語の原文を見るPersonal Aivy API key (aivy_sk_...). Optional: without one, register_account or sign_in creates and stores a key from the chat.
  • AIVY_API_URL API のベース URL。デフォルトは https://bridge.ivyenergy.com.au/v1
    英語の原文を見るAPI base URL. Default https://bridge.ivyenergy.com.au/v1
    · 初期値 https://bridge.ivyenergy.com.au/v1

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Aivy Energy を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user aivy -- uvx aivy-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "aivy": {
      "command": "uvx",
      "args": [
        "aivy-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aivy": {
      "command": "uvx",
      "args": [
        "aivy-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "aivy": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aivy-mcp"
      ]
    }
  }
}

自分で入力する値

  • AIVY_API_KEY 秘密 env
    個人用 Aivy API キー(aivy_sk_...)。任意です。設定しない場合、register_account または sign_in がチャットからキーを作成して保存します。
    英語の原文を見るPersonal Aivy API key (aivy_sk_...). Optional: without one, register_account or sign_in creates and stores a key from the chat.
  • AIVY_API_URL env
    API のベース URL。デフォルトは https://bridge.ivyenergy.com.au/v1
    英語の原文を見るAPI base URL. Default https://bridge.ivyenergy.com.au/v1

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
2,325/週
接続方法
パソコンで動く
最新バージョンi
0.9.2
カテゴリi
その他
レジストリ公開日i
2026年11月9日
コードの最終更新i
2026年11月19日
作者
IVYEnergy
パッケージ
pypi: aivy-mcp
ウェブサイト
bridge.ivyenergy.com.au
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント IVYEnergy で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に aivy-mcp@0.9.2 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ivyenergy-aivy-mcp.svg)](https://mcp.popnx.com/en/servers/ivyenergy-aivy-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20749件のうち91%よりスターが多い
  • このカテゴリのほかの20749件のうち82%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20749件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Aivy Energyは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(0.9.2)がレジストリに届いたのは10 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582514 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Aivy Energy
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/41/44/4
ライセンスApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

aivy-mcp

An MCP server that lets your own AI assistant (Claude Code, Claude Desktop, ChatGPT, Codex, Cursor, ...) read and control your own solar + battery system through the Aivy Developer API by Ivy Energy.

Works with every brand Aivy runs: Sungrow, Sigenergy, FoxESS, AlphaESS, SolaX and more. The same tools, whatever the inverter.

1. Get a key (or let the chat do it)

In the chat. Add the server without any key (step 2) and say "sign me up to Aivy" or "sign in to my Aivy account". The assistant walks through the terms, the emailed code and the permission level (read only, or read and control), and the server stores the key on your computer (~/.aivy/credentials.json, readable by you only). The key is never shown in the chat.

On the web. Open bridge.ivyenergy.com.au/developer, sign up or sign in, and create a key. Pick Read only to let an assistant look, or Read and control to let it change the energy mode, Ai+ settings and connect systems. Then pass it as AIVY_API_KEY (step 2). The key sees exactly what your account sees, nothing more.

No hardware yet? Every key also lists demo sites (sandbox:..., replayed real data); mode and Ai+ changes on them are kept for your account only and never reach hardware, so you can try everything first. Accounts and keys can also be created from the API itself; see the Quickstart.

2. Add the server

Claude Desktop, no terminal: download aivy-mcp- .mcpb from the latest release and open it; Claude Desktop installs it as an extension with the Aivy icon, and fetches the server with its own uv. Then say "sign me up to Aivy". (mcpb/build.py builds that file from the released package.)

One line (macOS, Linux; installs uv if missing, then writes the server into every MCP client it finds: Codex, Claude Code, Claude Desktop, Cursor):

curl -fsSL https://raw.githubusercontent.com/IVYEnergy/aivy-mcp/main/install.sh | sh

Already have uv? uvx --from aivy-mcp@latest aivy-mcp-setup does the same, and aivy-mcp setup --client codex --key aivy_sk_... targets one client or stores an existing key. Files are backed up before they change. Restart the client, then say "sign me up to Aivy". An assistant that can run shell commands (Claude Code, Codex) can run the line for you.

Or by hand. Claude Code (drop -e AIVY_API_KEY=... to sign up or sign in from the chat instead):

claude mcp add aivy -e AIVY_API_KEY=aivy_sk_... -- uvx aivy-mcp@latest

Codex (~/.codex/config.toml):

[mcp_servers.aivy]

command = "uvx" args = ["aivy-mcp@latest"]

optional: [mcp_servers.aivy.env] AIVY_API_KEY = "aivy_sk_..."

Claude Desktop / Cursor / any MCP client (mcpServers block):

{

"mcpServers": { "aivy": { "command": "uvx", "args": ["aivy-mcp@latest"], "env": { "AIVY_API_KEY": "aivy_sk_..." } } } }

No uv? pipx run aivy-mcp or pip install aivy-mcp && aivy-mcp work too.

Updating. aivy-mcp@latest makes uv check PyPI every time the client starts the server, so restarting the client is the update. An entry written before 0.11.3 ran plain uvx aivy-mcp, which uv keeps at the version it first resolved: run the one-line installer again and it rewrites the entry (key kept), or edit it by hand. The Claude Desktop extension pins its version: open the new .mcpb from the latest release. The server checks PyPI once per start and, when a newer release exists, the playbook (get_agent_guide) ends with a short update note the assistant passes on; AIVY_MCP_NO_UPDATE_CHECK=1 turns that off.

Assistants that cannot run local tools (ChatGPT in the browser) can use the HTTP API directly. Paste this into the chat:

Use the Aivy Developer API at https://bridge.ivyenergy.com.au/v1 with the

header Authorization: Bearer aivy_sk_.... Read

https://bridge.ivyenergy.com.au/v1/llms.txt first, then GET /sites.

3. Ask

  • "How's my battery doing?"
  • "Why did it charge at 3am?"
  • "What are prices doing tonight? Should I sell?"
  • "Plan the best time to sell tonight, keep 20%, then apply it."
  • "Charge at 5 kW to 90% for the next two hours." (control key)
  • "Make Ai+ a bit more aggressive on exports." (control key)
  • "Connect my Sungrow inverter, serial A2340000001, NMI 2001234567." (control key)
  • "Email me when the battery drops below 20%."
  • "I want to write my own strategy: sell above 40c, charge when import goes negative, hold overnight." (control key; the AI writes the rules, you approve)

For agents: the playbook

Tool descriptions say what each call does. The playbook says how to get a job done with them: which tools answer which questions, when to stop and confirm, how forced mode and its hand-back work, what each error means, and the step-by-step workflows (status, diagnosis, prices, earnings, selling tonight, keeping a reserve, charging now, connecting a system, Ai+ tuning). It is one text, delivered four ways:

WhereHow to use it
MCP tool get_agent_guideAny MCP client: the server's instructions ask the model to call it once per conversation.
Claude Code / Claude skillCopy skills/aivy into ~/.claude/skills/ (or a project's .claude/skills/).
Codex, Cursor, other rule filesPaste src/aivy_mcp/playbook.md into AGENTS.md or your rules.
HTTP-only assistants (ChatGPT in the browser)Tell it to read https://bridge.ivyenergy.com.au/v1/agent-guide.md first.
Checking an agent against it

evals/cases.json holds conversation cases (the user's words, the tools a good agent calls in order, the ones it must not call, and whether the turn has to end in a question). evals/check.py judges a transcript:

# Claude Code, headless, with the server configured as "aivy":

claude -p "Sell at the best prices tonight, keep 20%." --output-format stream-json > t.json python evals/check.py sell-tonight-propose t.json

A transcript can also be a plain list: [{"name": "get_status", "args": {}}], or {"calls": [...], "text": "final reply"}. Run the cases after changing the playbook, the tool descriptions or the model.

Cards in chat

Hosts that render MCP Apps (and ChatGPT through its Apps SDK) show sixteen of the tools as cards instead of text, in the same style as the Aivy mobile app, light and dark:

ToolCard
get_statusSOC ring and the four power flows (solar, home, grid, battery)
get_pricesBuying / selling now, the next hours as bars, the best hours to sell highlighted
plan_dischargeThe sell plan (revenue headline, the chosen windows on a timeline) or the hold-a-reserve plan, with an Apply button; the click is the user's yes and calls set_energy_mode
get_registration_termsA sign-up / sign-in form: email, password, permission level and the terms are entered in the card and sent to Aivy by the card itself, never through the chat
get_energy_modeControl panel: today's windows on a 24-hour bar, the pending hand-back, mode buttons and a manual charge / discharge form; under Ai+, its levers as sliders and switches built from the engine's own ranges, with Save. A click is the user's yes
list_vendorsConnect a system: pick the brand, enter what it needs (or sign in at the vendor), see the new site appear
get_curvePower history: solar, home, battery, grid lines with SOC
get_earningsA day's net, earned, cost, exported and imported, hour by hour
get_operationsTimeline of what the platform did and why
list_alertsAlert rules with Delete, and a form to add one; called with the rule the person asked for, the form comes filled in and one click adds it
create_alert, delete_alertThe same card, already showing the rule just added (marked new) or the remaining rules
list_sitesYour sites with a Status button each
start_strategy, get_strategy, end_strategyStrategy mode: the rules the AI wrote in plain words, what they would do right now, the lease and the limits, with Start; then the running strategy with its last action, recent decisions and Stop

Every card is one self-contained HTML document (no network, no assets), so it works under the extension's default content security policy. Hosts without the extension get the same data as JSON. To look at the cards locally: node tests/ui/shoot.mjs (needs playwright).

Tools

ToolChanges anything?What it does
get_agent_guidenoThe playbook above
get_registration_terms, register_account, verify_registrationaccount onlyCreate an Aivy account from the chat; the key is stored locally
sign_inaccount onlyCreate and store a key for an existing account (password used once)
list_sitesnoYour sites (ids look like sungrow:1445844) and whose key this is, read or control; says when there is no key yet
get_statusnoLive SOC and power flows, with the site's capacity, limits, timezone and mode
get_curveno5-minute or daily history
get_earningsnoA day's energy, priced at Amber's actual prices
get_operationsnoWhat the platform did and why
get_pricesnoAmber prices now and forecast
list_alertsnoAlert rules on a site and the 20 most recent firings
create_alert, delete_alertaccount onlyThreshold alerts to inbox, push and email; never control the battery
list_vendorsnoSupported brands and what connecting one needs
connect_siteyesLink the user's system (serial + NMI, system id, or an OAuth link to open)
disconnect_siteyesRemove a site from the account
get_energy_modenoMode, windows, pending hand-back; Ai+ variant, settings and tunable ranges
set_energy_modeyesselfConsumption / amber_smart (Ai+) / au_forecast_export, au_negative_price, au_smart_energy, au_weather_season (AU-01..04 student strategies) / forced (time-boxed); without a mode, change Ai+ levers or variant
plan_dischargenoPropose a sell schedule from the forecast (goal: best_price) or a discharge that lands on a SOC at a time (goal: target_soc)
get_strategynoStrategy mode: what is running
start_strategy, end_strategyyesPreview the AI-written rules against the readings (a dry run), then run them or replace the running ones; stop them. Nothing starts without the previewed proposal_id; the server keeps the limits and hands the site back when it ends

What the server enforces, whatever the assistant does

  • A key sees only its owner's sites; writes need the control scope.
  • A forced (manual) mode set through the API always reverts to the previous mode after duration_minutes (default 4 h, max 24 h).
  • A strategy written by the AI runs on a lease (default a day, max a week), may change the action at most three times an hour, treats stale readings as auto, and hands the site back to its previous mode when it ends.
  • The SOC floor and grid export limits cannot be overridden.
  • Every call is recorded with the key id and client; keys can be revoked in the app at any time and stop working immediately.
  • Per-key rate limit (default 120/min). Readings refresh about once a minute.

Development

git clone https://github.com/IVYEnergy/aivy-mcp && cd aivy-mcp

uv run --with pytest pytest uv run aivy-mcp # needs AIVY_API_KEY

The package also lives in Ivy Energy's main repository under sdk/aivy-mcp; this public repository is where it

冒頭だけを表示しています。続きはリポジトリで読めます