weishaupt-wem-mcp-server
Weishaupt WEM Portal MCP Server
WEM Portalを介して、AIアシスタントでWeishaupt暖房システムを制御・監視します
特徴
Device Discovery - WEM Portalアカウントのすべてのデバイスとモジュールを一覧表示します
Live Parameters - 温度、圧力、運転モードを現在値で読み取ります
Full Overview - 1回の呼び出しで暖房システム全体の完全なスナップショットを取得します
Write Parameters - 目標温度、運転モード、スケジュールを調整します
Device Status - デバイスの接続状態を確認します
Writable Filter - 実際に変更できるパラメータのみを一覧表示します
Session Management - Cookieベースの自動認証と、同時リクエスト用のログインロックを備えています
Related MCP server: victron-tcp
クイックスタート
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の設定に以下を追加します:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"weishaupt-wem": {
"command": "npx",
"args": ["-y", "@disane-dev/weishaupt-wem-mcp-server"],
"env": {
"WEM_USERNAME": "your_email@example.com",
"WEM_PASSWORD": "your_password"
}
}
}
}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": "your_email@example.com",
"WEM_PASSWORD": "your_password"
}
}
}
}環境変数
変数 | 必須 | 説明 |
| はい | WEM Portalのメールアドレス |
| はい | WEM Portalのパスワード |
| いいえ | APIベースURL(デフォルト: |
利用可能なツール
ツール | 説明 |
| モジュールを含むすべてのデバイスを一覧表示します。IDを確認するにはこれを最初に呼び出してください。 |
| デバイスの接続状態を取得します |
| デバイスの完全な概要:全モジュールの全パラメータを1回の呼び出しで取得します |
| モジュールの全パラメータと現在値を取得します |
| パラメータのメタデータ(名前、最小/最大値、列挙値、書き込み可能フラグ)を取得します |
| 範囲とオプション付きで調整可能なパラメータのみを一覧表示します |
| IDを指定して特定のパラメータ値を読み取ります |
| パラメータ値を設定します(例:目標温度) |
[!TIP] まず
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 | グラウンドモジュール |
開発
コマンド | 説明 |
| プロジェクトをビルドします |
| ウォッチモード(変更時に自動リビルド) |
| サーバーを直接実行します |
| API接続をテストします |
| 公式MCP Inspector(Web UI) |
| クイックAPIテスト用のCLIインスペクタ |
トラブルシューティング
[!NOTE] このサーバーを使用する前に、wemportal.com にログインできることを確認してください。
問題 | 解決方法 |
認証に失敗する | 認証情報を確認し、試行回数が多すぎるとWEM Portalがブロックされないか確認してください |
接続がタイムアウトする | インターネット接続を確認してください。WEM Portalが一時的に利用できない可能性があります(デフォルトのタイムアウトは30秒) |
パラメータ値が0と表示される | 一部のパラメータ(例:室温)は、デバイスに物理センサーが接続されている必要があります |
コントリビューション
コントリビューションを歓迎します!問題を報告するか、プルリクエストを送信してください。
ライセンス
MIT - LICENSE を参照
disane.dev | Blog | GitHub | npm
This server cannot be deployed
Maintenance
Related MCP Connectors
Home energy for AI assistants: live Power flow, Energy history, solar forecast, and device control.
1- mytesla.ioOAuthio.mytesla
Control your Tesla from your AI assistant - climate, charging, access, and security.
weclapp ERP in your AI assistant: reads instantly, writes only after a preview you approve.
Heating, ventilation and energy engineering calculations and diagnostics for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Home Assistant smart home devices through natural language. Control devices, manage automations, query entity states, and retrieve historical data across your home automation system.1MIT
- AlicenseAqualityAmaintenanceConnect AI assistants to Victron Energy systems to read real-time solar, battery, grid, and inverter data from your local network via Modbus TCP or MQTT.3295 npm4MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLM applications to query and visualize data from Bosch/Buderus heat pumps via ems-ESP, including temperatures, statistics, and heat curves through natural language.9MIT
- AlicenseAqualityDmaintenanceAn unofficial MCP (Model Context Protocol) server that exposes a Vaillant heat pump's data to AI assistants like Claude. Query outdoor and room temperatures, hot water status, energy consumption, COP estimates, schedules, and diagnostics through natural conversation.4MIT