Weishaupt WEM门户MCP服务器
通过WEM门户使用AI助手控制和监控您的Weishaupt供暖系统
](https://github.com/Disane87/weishaupt-wem-mcp-server/releases) ](https://www.npmjs.com/package/@disane-dev/weishaupt-wem-mcp-server)   
  ](https://nodejs.org/) 
______________________________________________________________________
特性
- 设备发现 -列出您的WEM门户帐户中的所有设备和模块
- 实时参数 -读取当前值的温度、压力、操作模式
- 完整概述 -在一次通话中获取整个供暖系统的完整快照
- 写入参数 -调整目标温度、操作模式、时间表
- 设备状态 -检查设备的连接状态
- 可写过滤器 -仅列出您实际可以更改的参数
- 会话管理 -基于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配置中:
- 窗户:
%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": "your_email@example.com",
"WEM_PASSWORD": "your_password"
}
}
}
}Claude Code
claude mcp add weishaupt-wem -- npx -y @disane-dev/weishaupt-wem-mcp-server设置环境变量 WEM_USERNAME 和 WEM_PASSWORD 在开始之前。
From source
{
"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_USERNAME | 是 | 您的WEM门户电子邮件 |
WEM_PASSWORD | 是 | 您的WEM门户密码 |
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 | 系统 | 系统概述 |
| 2 | HZK | 加热电路(温度、工作模式) |
| 3 | WW | 热水(温度、压力、时间表) |
| 5 | TERMINAL | 控制面板 |
| 6 | 网关 | 通信网关 |
| 7 | WE | 热发生器(锅炉/热泵性能) |
| 9 | 设备 | 物理设备单元 |
| 10 | GROUND | 接地模块 |
______________________________________________________________________
发展
| 命令 | 描述 |
|---|---|
npm run build | 构建项目 |
npm run watch | 监视模式(更改后自动重建) |
npm start | 直接运行服务器 |
npm test | 测试API连接 |
npm run inspector | MCP官方检查员(Web UI) |
npm run inspector:cli -- devices | 用于快速API测试的CLI检查器 |
______________________________________________________________________
故障排除
\[!注意\] 请确保您可以登录 wemportal.com 在使用此服务器之前。
| 问题 | 解决方案 |
|---|---|
| 身份验证失败 | 验证凭据,检查WEM门户是否在多次尝试后被阻止 |
| 连接超时 | 检查互联网,WEM门户可能暂时不可用(默认超时30秒) |
| 参数值显示0 | 某些参数(如室温)需要连接到设备的物理传感器 |
______________________________________________________________________
贡献
欢迎投稿!请打开问题或提交拉取请求。
______________________________________________________________________
许可证
麻省理工学院-见 许可证
______________________________________________________________________
disane.dev | 博客 | ** | **
