Weishaupt WEM Portal について
Weishaupt WEM Portalは、WEM Portal経由でWeishaupt暖房システムを監視・調整するMCPサーバーです。デバイス検出、現在値の取得、システム概要、変更可能なパラメーターの操作に対応します。
主な機能
- 01デバイスとモジュールの検出
- 02現在のパラメーターと状態の取得
- 03システム全体のスナップショット表示
- 04変更可能な項目と範囲の一覧
- 05目標温度・モード・スケジュールの変更
活用シーン
- 01暖房システムの状態確認
- 02温度と運転モードの確認
- 03目標温度やスケジュールの調整
MCP 対応
WEM Portalのデバイス、状態、概要、パラメーター読み取り、メタデータ、書き込み用ツールをMCPクライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @disane-dev/weishaupt-wem-mcp-serverWEM_USERNAMEYour WEM Portal email/usernameWEM_PASSWORDシークレットYour WEM Portal passwordWEM_API_URLWEM Portal API URL (default: https://www.wemportal.com/app)ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
機能
- デバイスの検出 - 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_parameters | IDを指定して特定のパラメーター値を読み取ります |
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)
一般的なモジュールの種類
| 種類 | 名前 | 説明 |
|---|---|---|
| 1 | SYSTEM | システム概要 |
| 2 | HZK | 暖房回路(温度、運転モード) |
| 3 | WW | 温水(温度、プッシュ、スケジュール) |
| 5 | TERMINAL | コントロールパネル |
| 6 | GATEWAY | 通信ゲートウェイ |
| 7 | WE | 熱発生装置(ボイラー/ヒートポンプの性能) |
| 9 | Device | 物理デバイスユニット |
| 10 | GROUND | 地中モジュール |
開発
| コマンド | 説明 |
|---|---|
npm run build | プロジェクトをビルドします |
npm run watch | ウォッチモード(変更時に自動再ビルド) |
npm start | サーバーを直接実行します |
npm test | API 接続をテストします |
npm run inspector | 公式 MCP Inspector(Web UI) |
npm run inspector:cli -- devices | API をすばやくテストするための CLI インスペクター |
トラブルシューティング
メモ
このサーバーを使用する前に、wemportal.com にログインできることを確認してください。
| 問題 | 解決方法 |
|---|---|
| 認証に失敗する | 認証情報を確認し、試行回数が多すぎて WEM Portal にブロックされていないか確認してください |
| 接続がタイムアウトする | インターネット接続を確認してください。WEM Portal が一時的に利用できない可能性があります(デフォルトのタイムアウトは 30s) |
| パラメーター値が 0 と表示される | 一部のパラメーター(例:室温)には、デバイスに物理センサーが接続されている必要があります |
コントリビューション
コントリビューションを歓迎します!イシューを作成するか、プルリクエストを送信してください。
ライセンス
MIT - LICENSE を参照してください
disane.dev | ブログ | GitHub | npm
Subthielで開発・制作しました。Subthiel — ソフトウェア開発・3Dプリント
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。