MeteoControl MCPサーバー

MeteoControl VCOM API v2用のModel Context Protocol (MCP) サーバーです。この拡張機能を使用すると、Gemini CLIを介して自然言語で太陽光発電アレイの監視、エネルギー生産データの取得、システム健全性チェックを行うことができます。

機能

• システム検出: アカウントに関連付けられたすべての太陽光発電システムを一覧表示します。

• エネルギー監視: 過去のエネルギー生産データ (Wh/kWh/MWh) を取得します。

• 資産情報: パネル、インバーター、サイト容量に関する技術的な詳細を取得します。

• リアルタイム電力: 現在のAC出力電力を確認します。

• マルチトランスポートサポート: Stdio経由でローカル実行、またはSSE経由でリモートホストが可能です。

• マルチテナント (BYOC): 共有環境での「Bring Your Own Credentials (独自の認証情報を使用)」をサポートします。

インストール

Gemini CLI経由 (推奨)

GitHubから直接拡張機能をインストールするには:

gemini extensions add https://github.com/your-org/meteocontrol-mcp

手動インストール

1. リポジトリをクローンします:

   git clone https://github.com/your-org/meteocontrol-mcp.git
   cd meteocontrol-mcp

2. 依存関係をインストールしてビルドします:

   npm install
   npm run build

使用方法

インストール後、Geminiに太陽光発電システムについて質問できます:

• 「私の太陽光発電システムを一覧表示して。」

• 「システム [systemKey] の過去24時間のエネルギー生産量は？」

• 「システム [systemKey] の INV1 の技術詳細を表示して。」

マルチテナントでの使用 (BYOC)

共有MCPサーバーを使用している場合、プロンプト内で直接独自の認証情報を提供するか、ローカルで設定できます。ツールはオプションの apiKey、user、password 引数を受け付けます。

事前設定済みコマンド

• /health [systemKey]: 包括的なサイト健全性チェックを実行します。

• /yield [systemKey]: エネルギー生産データを取得して要約します。

デプロイとホスティング

このサーバーは複数の動作モードをサポートしています:

1. ローカルモード (Stdio)

Gemini CLIで使用されるデフォルトのモードです。

• コマンド: node dist/index.js

• 設定: gemini-extension.json 内で command と args を使用して定義します。

2. リモートモード (SSE)

複数のユーザー向けに中央サーバーでMCPサーバーをホストする場合にこのモードを使用します。

セキュリティ: アクセストークンの生成

リモートモードでは、セキュリティのために MCP_SERVER_TOKEN が必須です。以下のコマンドで安全なトークンを生成できます:

openssl rand -base64 32

サーバー設定

• 環境変数:

  • MCP_TRANSPORT=sse

  • MCP_SERVER_TOKEN=生成したトークン (必須)

  • PORT=3000 (オプション、デフォルトは3000)

• 実行コマンド:

  MCP_TRANSPORT=sse MCP_SERVER_TOKEN=your_token node dist/index.js

3. Dockerモード

コンテナとして実行することで簡単にデプロイできます。

Stdioモード (CLI使用時):

docker run -i --rm \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

SSEモード (ホスト使用時):

docker run -d \
  -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e MCP_SERVER_TOKEN=your_token \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

クライアント設定 (SSE用)

ローカルの .gemini/settings.json に url と Authorization ヘッダーを追加します:

{
  "mcpServers": {
    "meteocontrol": {
      "url": "https://your-mcp-server.com/sse",
      "headers": {
        "Authorization": "Bearer your_generated_token"
      }
    }
  }
}

設定

サーバーがMeteoControlと通信するには、以下の環境変数が必要です (リクエストごとに認証情報が提供される場合を除く):

• METEOCONTROL_API_KEY: VCOM APIキー。

• METEOCONTROL_USER: VCOMユーザー名 (メールアドレス)。

• METEOCONTROL_PASSWORD: VCOMパスワード。

ライセンス

Apache License 2.0