mcpField
W
Weishaupt WEM Portal

Weishaupt WEM Portal

ローカル
github.com/Disane87その他03 週間前に更新

Weishaupt WEM Portal について

Weishaupt WEM Portalは、WEM Portal経由でWeishaupt暖房システムを監視・調整するMCPサーバーです。デバイス検出、現在値の取得、システム概要、変更可能なパラメーターの操作に対応します。

主な機能

  1. 01デバイスとモジュールの検出
  2. 02現在のパラメーターと状態の取得
  3. 03システム全体のスナップショット表示
  4. 04変更可能な項目と範囲の一覧
  5. 05目標温度・モード・スケジュールの変更

活用シーン

  1. 01暖房システムの状態確認
  2. 02温度と運転モードの確認
  3. 03目標温度やスケジュールの調整

MCP 対応

WEM Portalのデバイス、状態、概要、パラメーター読み取り、メタデータ、書き込み用ツールをMCPクライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"disane87-weishaupt-wem": {
"command": "npx",
"args": [
"-y",
"@disane-dev/weishaupt-wem-mcp-server"
],
"env": {
"WEM_USERNAME": "<WEM_USERNAME>",
"WEM_PASSWORD": "<WEM_PASSWORD>",
"WEM_API_URL": "<WEM_API_URL>"
}
}
}
}
起動コマンドnpx -y @disane-dev/weishaupt-wem-mcp-server
設定が必要な環境変数
WEM_USERNAMEYour WEM Portal email/username
WEM_PASSWORDシークレットYour WEM Portal password
WEM_API_URLWEM Portal API URL (default: https://www.wemportal.com/app)

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@disane-dev/weishaupt-wem-mcp-server0.2.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

WEM Portal

Weishaupt WEM Portal MCP サーバー

WEM Portal 経由で AI アシスタントを使って、Weishaupt の暖房システムを操作・監視できます

Version npm License: MIT Blog Website

MCP TypeScript Node.js semantic-release

GitHub Stars GitHub Issues CI


機能

  • デバイスの検出 - WEM Portal アカウントに登録されているすべてのデバイスとモジュールを一覧表示します
  • リアルタイムのパラメーター - 温度、圧力、運転モードの現在値を読み取ります
  • 全体の概要 - 1 回の呼び出しで暖房システム全体のスナップショットを取得します
  • パラメーターの書き込み - 目標温度、運転モード、スケジュールを調整します
  • デバイスのステータス - デバイスの接続状態を確認します
  • 書き込み可能な項目のフィルター - 実際に変更できるパラメーターのみを一覧表示します
  • セッション管理 - 同時リクエスト時のログインロックを備えた、Cookie ベースの自動認証

クイックスタート

npx でインストール(推奨)

インストールは不要です。次のコマンドを実行するように MCP クライアントを設定してください。

npx @disane-dev/weishaupt-wem-mcp-server
ソースからインストール
git clone https://github.com/Disane87/weishaupt-wem-mcp-server.git
cd weishaupt-wem-mcp-server
npm install
npm run build

設定

Claude Desktop

Claude Desktop の設定に追加します。

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "weishaupt-wem": {
      "command": "npx",
      "args": ["-y", "@disane-dev/weishaupt-wem-mcp-server"],
      "env": {
        "WEM_USERNAME": "[email protected]",
        "WEM_PASSWORD": "your_password"
      }
    }
  }
}
Claude Code
claude mcp add weishaupt-wem -- npx -y @disane-dev/weishaupt-wem-mcp-server

起動前に環境変数 WEM_USERNAME と WEM_PASSWORD を設定してください。

ソースから実行
{
  "mcpServers": {
    "weishaupt-wem": {
      "command": "node",
      "args": ["/path/to/wem-mcp/build/index.js"],
      "env": {
        "WEM_USERNAME": "[email protected]",
        "WEM_PASSWORD": "your_password"
      }
    }
  }
}
環境変数
変数必須説明
WEM_USERNAMEはいWEM Portal のメールアドレス
WEM_PASSWORDはいWEM Portal のパスワード
WEM_API_URLいいえAPI のベース URL(デフォルト:https://www.wemportal.com/app)

利用可能なツール

ツール説明
wem_get_devicesモジュールを含むすべてのデバイスを一覧表示します。最初に呼び出してください。IDを確認できます。
wem_get_device_statusデバイスの接続状態を取得します
wem_get_overviewデバイスの全体概要:すべてのモジュールと全パラメーターを一度に取得します
wem_get_parametersモジュールのすべてのパラメーターと現在値を取得します
wem_get_parameter_metaパラメーターのメタデータ(名前、最小値/最大値、列挙値、書き込み可能かどうか)を取得します
wem_get_writable_parameters調整可能なパラメーターのみを、範囲と選択肢とともに一覧表示します
wem_read_parametersIDを指定して特定のパラメーター値を読み取ります
wem_write_parameterパラメーター値を設定します(例:目標温度)

ヒント

まず wem_get_devices で deviceId、moduleIndex、moduleType を確認し、次に wem_get_overview を使って暖房システムの全体像を取得してください。


一般的なワークフロー

1. wem_get_devices
   -> Returns devices with modules (WE0=heat generator, HZK0=heating circuit, WW0=hot water)

2. wem_get_overview (deviceId)
   -> Returns ALL modules with ALL parameters in one call

3. wem_get_writable_parameters (deviceId, moduleIndex, moduleType)
   -> Shows what you can adjust, with min/max ranges

4. wem_write_parameter (deviceId, moduleIndex, moduleType, parameterId, numericValue)
   -> Sets a writable parameter (e.g. target temperature)
一般的なモジュールの種類
種類名前説明
1SYSTEMシステム概要
2HZK暖房回路(温度、運転モード)
3WW温水(温度、プッシュ、スケジュール)
5TERMINALコントロールパネル
6GATEWAY通信ゲートウェイ
7WE熱発生装置(ボイラー/ヒートポンプの性能)
9Device物理デバイスユニット
10GROUND地中モジュール

開発

コマンド説明
npm run buildプロジェクトをビルドします
npm run watchウォッチモード(変更時に自動再ビルド)
npm startサーバーを直接実行します
npm testAPI 接続をテストします
npm run inspector公式 MCP Inspector(Web UI)
npm run inspector:cli -- devicesAPI をすばやくテストするための CLI インスペクター

トラブルシューティング

メモ

このサーバーを使用する前に、wemportal.com にログインできることを確認してください。

問題解決方法
認証に失敗する認証情報を確認し、試行回数が多すぎて WEM Portal にブロックされていないか確認してください
接続がタイムアウトするインターネット接続を確認してください。WEM Portal が一時的に利用できない可能性があります(デフォルトのタイムアウトは 30s)
パラメーター値が 0 と表示される一部のパラメーター(例:室温)には、デバイスに物理センサーが接続されている必要があります

コントリビューション

コントリビューションを歓迎します!イシューを作成するか、プルリクエストを送信してください。


ライセンス

MIT - LICENSE を参照してください



Subthielで開発・制作しました。Subthiel — ソフトウェア開発・3Dプリント

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。