Weishaupt WEM Portal

io.github.Disane87由 GitHub 帳號 Disane87 發布v0.2.0更新於 Oct 27, 2026

Control and monitor Weishaupt heating systems via the WEM Portal

已驗證STDIO僅桌面位置與生活效率與工作流

概覽

AI 產生的概覽

將助理連接到 Weishaupt WEM Portal 帳號，可列出暖氣設備、讀取即時參數並修改可寫入的設定。

可以做什麼
  • 列出設備與模組，並查看設備連線狀態
  • 讀取即時參數與中繼資料，例如名稱、數值範圍、列舉值與可寫入旗標
  • 一次呼叫取得所有模組與參數的完整快照
  • 僅列出可調整的參數及其範圍與選項
  • 寫入參數值，例如目標溫度、運轉模式與排程
適用情境
適合擁有 Weishaupt 暖氣系統的使用者，想透過 AI 助理查看溫度、壓力、運轉模式，或調整目標溫度與排程，而不必使用 WEM Portal 網頁介面。
執行需求
透過 npx（需 Node.js）在本機執行，或從原始碼建置後執行。需要 WEM Portal 帳號，並設定 WEM_USERNAME 與 WEM_PASSWORD 環境變數；WEM_API_URL 為選用，預設指向公開入口網站。需要能連線至該入口網站的網路。
安裝前請注意
伺服器會把 WEM Portal 電子郵件與密碼存放在 MCP 用戶端設定中，並代為登入。寫入類工具會變更實際的暖氣設定，例如目標溫度與排程，可能影響舒適度、能耗或設備，請在套用前確認。憑證會傳送到所設定的入口網站位址，僅在信任的主機上修改 WEM_API_URL。多次登入失敗可能導致帳號被鎖定。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Weishaupt WEM Portal，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[WEM Portal]

Weishaupt WEM Portal MCP Server

Control and monitor your Weishaupt heating system with AI assistants via the WEM Portal

[Version] [npm] [License: MIT] [Blog] [Website]

[MCP] [TypeScript] [Node.js] [semantic-release]

[GitHub Stars] [GitHub Issues] [CI]

Features

  • Device Discovery - List all devices and modules from your WEM Portal account
  • Live Parameters - Read temperatures, pressure, operating modes with current values
  • Full Overview - Get a complete snapshot of your entire heating system in one call
  • Write Parameters - Adjust target temperatures, operating modes, schedules
  • Device Status - Check connection status of your devices
  • Writable Filter - List only the parameters you can actually change
  • Session Management - Automatic cookie-based auth with login lock for concurrent requests

Quick Start

Install via npx (recommended)

No installation needed. Configure your MCP client to run:

bash
npx @disane-dev/weishaupt-wem-mcp-server

Install from source

bash
git clone https://github.com/Disane87/weishaupt-wem-mcp-server.gitcd weishaupt-wem-mcp-servernpm installnpm run build

Configuration

Claude Desktop

Add to your Claude Desktop config:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
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
bash
claude mcp add weishaupt-wem -- npx -y @disane-dev/weishaupt-wem-mcp-server

Set the environment variables WEM_USERNAME and WEM_PASSWORD before starting.

From source
json
{  "mcpServers": {    "weishaupt-wem": {      "command": "node",      "args": ["/path/to/wem-mcp/build/index.js"],      "env": {        "WEM_USERNAME": "[email protected]",        "WEM_PASSWORD": "your_password"      }    }  }}

Environment Variables

VariableRequiredDescription
WEM_USERNAMEYesYour WEM Portal email
WEM_PASSWORDYesYour WEM Portal password
WEM_API_URLNoAPI base URL (default: https://www.wemportal.com/app)

Available Tools

ToolDescription
wem_get_devicesList all devices with modules. Call this first to discover IDs.
wem_get_device_statusGet connection status of a device
wem_get_overviewFull device overview: all modules with all parameters in one call
wem_get_parametersGet all parameters of a module with current values
wem_get_parameter_metaGet parameter metadata (names, min/max, enums, writable flag)
wem_get_writable_parametersList only adjustable parameters with ranges and options
wem_read_parametersRead specific parameter values by ID
wem_write_parameterSet a parameter value (e.g., target temperature)

[!TIP] Start with wem_get_devices to discover your deviceId, moduleIndex, and moduleType, then use wem_get_overview for a complete snapshot of your heating system.

Typical Workflow

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)

Common Module Types

TypeNameDescription
1SYSTEMSystem overview
2HZKHeating circuit (temperatures, operating mode)
3WWHot water (temperature, push, schedule)
5TERMINALControl panel
6GATEWAYCommunication gateway
7WEHeat generator (boiler/heat pump performance)
9DevicePhysical device unit
10GROUNDGround module

Development

CommandDescription
npm run buildBuild the project
npm run watchWatch mode (auto-rebuild on changes)
npm startRun server directly
npm testTest API connection
npm run inspectorOfficial MCP Inspector (Web UI)
npm run inspector:cli -- devicesCLI inspector for quick API tests

Troubleshooting

[!NOTE] Make sure you can log in at wemportal.com before using this server.

IssueSolution
Authentication failedVerify credentials, check if WEM Portal blocks after too many attempts
Connection timeoutCheck internet, WEM Portal may be temporarily unavailable (30s default timeout)
Parameter values show 0Some parameters (e.g. room temperature) require a physical sensor connected to the device

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT - see LICENSE

Made by me at Subthiel — software development & 3D printing

來源：README.md，提交 00f659c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分