mcpField
W
Weishaupt WEM Portal

Weishaupt WEM Portal

本地服务
github.com/Disane87其他03 周前更新

关于 Weishaupt WEM Portal

Weishaupt WEM Portal 是通过 WEM Portal 监控和调整 Weishaupt 供暖系统的 MCP 服务。它提供设备发现、实时参数读取、系统概览及可写参数控制。

主要功能

  1. 01发现设备和模块
  2. 02读取实时参数与状态
  3. 03查看完整系统快照
  4. 04列出可调参数及范围
  5. 05修改目标温度、模式和计划

适用场景

  1. 01查看供暖系统状态
  2. 02检查温度与运行模式
  3. 03调整目标温度或运行计划

MCP 相关

该服务向 MCP 客户端提供 WEM Portal 的设备、状态、概览、参数读取、元数据和参数写入工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"disane87-weishaupt-wem": {
"command": "npx",
"args": [
"-y",
"@disane-dev/weishaupt-wem-mcp-server"
],
"env": {
"WEM_USERNAME": "<WEM_USERNAME>",
"WEM_PASSWORD": "<WEM_PASSWORD>",
"WEM_API_URL": "<WEM_API_URL>"
}
}
}
}
启动命令npx -y @disane-dev/weishaupt-wem-mcp-server
需要配置的环境变量
WEM_USERNAMEYour WEM Portal email/username
WEM_PASSWORD密钥Your WEM Portal password
WEM_API_URLWEM Portal API URL (default: https://www.wemportal.com/app)

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@disane-dev/weishaupt-wem-mcp-server0.2.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

WEM Portal

Weishaupt WEM Portal MCP 服务

通过 WEM Portal 使用 AI 助手控制和监控您的 Weishaupt 供暖系统

Version npm License: MIT Blog Website

MCP TypeScript Node.js semantic-release

GitHub Stars GitHub Issues CI


功能

  • 设备发现 - 列出 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)
常见模块类型
类型名称描述
1SYSTEM系统概览
2HZK供暖回路(温度、运行模式)
3WW热水(温度、强制加热、计划)
5TERMINAL控制面板
6GATEWAY通信网关
7WE热源设备(锅炉/热泵性能)
9Device实体设备单元
10GROUND地源模块

开发

命令描述
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



由我在 Subthiel 制作 — 软件开发与 3D 打印

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。