关于 Weishaupt WEM Portal
Weishaupt WEM Portal 是通过 WEM Portal 监控和调整 Weishaupt 供暖系统的 MCP 服务。它提供设备发现、实时参数读取、系统概览及可写参数控制。
主要功能
- 01发现设备和模块
- 02读取实时参数与状态
- 03查看完整系统快照
- 04列出可调参数及范围
- 05修改目标温度、模式和计划
适用场景
- 01查看供暖系统状态
- 02检查温度与运行模式
- 03调整目标温度或运行计划
MCP 相关
该服务向 MCP 客户端提供 WEM Portal 的设备、状态、概览、参数读取、元数据和参数写入工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
mcp.json · 通用配置
启动命令
npx -y @disane-dev/weishaupt-wem-mcp-server需要配置的环境变量
WEM_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 账户中的所有设备和模块
- 实时参数 - 读取当前温度、压力和运行模式
- 完整概览 - 一次调用即可获取整个供暖系统的完整快照
- 写入参数 - 调整目标温度、运行模式和计划
- 设备状态 - 检查设备的连接状态
- 可写参数筛选 - 仅列出您实际可以更改的参数
- 会话管理 - 基于 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 测试的命令行检查器 |
故障排除
说明
使用此服务前,请确保能够登录 wemportal.com。
| 问题 | 解决方案 |
|---|---|
| 身份验证失败 | 核实凭据,并检查 WEM Portal 是否因尝试次数过多而阻止登录 |
| 连接超时 | 检查互联网连接;WEM Portal 可能暂时不可用(默认超时时间为 30s) |
| 参数值显示为 0 | 某些参数(例如室温)需要设备连接实体传感器 |
贡献
欢迎贡献!请提交 issue 或拉取请求。
许可证
MIT - 详见 LICENSE
disane.dev | 博客 | GitHub | npm
由我在 Subthiel 制作 — 软件开发与 3D 打印
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。