fronius-mcp

fronius-mcp

Fronius インバーターのリアルタイムの太陽光発電データを、Claude で直接確認できます。

次のようなことを質問できます。

「現在、どのくらい発電していますか？」

「バッテリーの充電レベルはどのくらいですか？」

「現在、電力を系統から購入していますか、それとも系統に売電していますか？」

「今年はどのくらい発電しましたか？」

「太陽光発電システムで何ができますか？」

「太陽光発電システムを分析してください。」

ローカルネットワーク上の Fronius Solar API v1 に直接接続します。クラウドアカウントもサブスクリプションも不要で、データが自宅の外に送信されることもありません。

---

仕組み

fronius-mcp は Model Context Protocol (MCP) サーバーです。MCP は、Claude などの AI アシスタントが外部のツールやデータソースに接続できるようにするオープン標準です。設定が完了すると、Claude はインバーターのローカル API をリアルタイムで呼び出せます。太陽光発電システムについて質問すると、その時点で取得したデータに基づいて回答します。

---

要件

• Solar API（JSON API）が有効になっている、ローカルネットワーク上の Fronius インバーター
• Claude Desktop
• uv — 高速な Python パッケージマネージャー（1 行でインストール）

---

セットアップ

1. uv をインストールする

uv は、高速な Python パッケージマネージャーです。恒久的にインストールせずに fronius-mcp を実行するために使用します。

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）:

irm https://astral.sh/uv/install.ps1 | iex

インストール後、ターミナルを再起動してください。

2. Claude Desktop に追加する

claude_desktop_config.json を開き、mcpServers 内に fronius ブロックを追加します。

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

設定ファイルの場所：

プラットフォーム	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Windows（Store アプリ）	%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

ヒント： mcpServers キーがすでにある場合は、その中に fronius ブロックを追加するだけです。mcpServers をもう 1 つ作成しないでください。

3. Claude Desktop を再起動する

新しいサーバー設定を読み込むために、Claude Desktop を終了して再度開きます。

4. インバーターを設定する

Claude との新しい会話で、次のように伝えます。

「192.168.178.35 にある Fronius インバーターを設定してください」

Claude がインバーターの IP アドレスを保存し、接続を確認します。この操作は一度だけです。アドレスは ~/.fronius-mcp.json に保存され、再起動後も保持されます。

インバーターの IP アドレスがわからない場合： Claude に 「Fronius インバーターを設定したいのですが、IP アドレスがわかりません」 と伝えてください。ルーター、Fronius Solar.web、インバーターのタッチディスプレイを使って IP アドレスを確認する方法を案内します。また、まだ有効にしていない場合は、インバーターの Web インターフェースで Solar API を有効にする方法も説明します。

---

質問できること

セットアップが完了したら、Claude に自然な言葉で話しかけてください。たとえば、次のように質問できます。

• 「現在の太陽光発電出力はどのくらいですか？」 — PV のリアルタイム発電量（ワット）
• 「現在のエネルギー自給率はどのくらいですか？」 — 自給率と自家消費率
• 「バッテリーは充電中ですか、それとも放電中ですか？」 — バッテリーの電力フローと充電状態
• 「今日はどのくらいの電力を系統に供給しましたか？」 — スマートメーターから取得した電力量の合計
• 「インバーターにはどのデバイスが接続されていますか？」 — システム全体の構成
• 「太陽光発電システムの全体像を教えてください。」 — Claude がすべてのデータソースをまとめて概要を作成

---

ツール

ツール	機能
configure_inverter	インバーターの IP アドレスを設定します。初回セットアップ時に一度だけ実行してください
solar_power_flow	太陽光発電量、系統との電力のやり取り、家庭の消費電力、バッテリー電力、自給率、エネルギー総量
solar_meter	相ごとの系統電力、累積の電力量（受電・送電）、電圧、電流、周波数
solar_battery	充電率、電圧、電流、温度、容量、ステータス
solar_devices	接続されているすべてのデバイスの種類、バスインデックス、シリアル番号

---

互換性のあるハードウェア

以下の環境で開発・テストされています。

• Fronius Symo GEN24 10.0 Plus
• BYD Battery-Box Premium HV（13.824 kWh）
• Fronius Smart Meter（系統への送電地点、3 相）

Solar API v1 に対応するその他の Fronius インバーターでも動作するはずです。API エンドポイントの挙動はモデルによって異なる場合があります。お使いのハードウェアで動作しない場合は、issue を作成してください。

---

ライセンス

Apache 2.0 — LICENSE を参照してください。