热泵聊天服务

通过MCP服务器将博世/布德鲁斯热泵集成到LLM应用中,实现自然语言交互查询热泵状态和设置。

  • by bosch-buderus-wp
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 bosch-buderus-wp/emsesp-mcp-server

使用说明

MCP Server for Bosch/Buderus heat pumps

LLM-powered chat for your heat pump


Get hot water temperature and COP of preparation


Get graph of configured heat curve

📔 目录

🚀 关于

有了这个 模型上下文协议(MCP) 服务器,您可以集成您的 博世CS5800/6800i或布德鲁斯WLW176/186i热泵 通过 ems esp 进入a 大型语言模型(LLM)应用 例如 克劳德桌面.

然后像这样拍摄你的提示:

  • 热水准备现在正在运行吗?
  • 目前的室外温度是多少?
  • 目前家用热水有多热?
  • 我的热泵目前用电量是多少?
  • 热水制备的COP(性能系数)是多少?

LLM将选择必要的 工具 由MCP服务器提供以回答问题。

或者,您可以简单地使用内置 提示 由MCP服务器提供:

  • /show-dhw-settings 以表格形式获取生活热水制备的所有设置
  • /show-heat-curve 以图表形式显示配置的热曲线
  • …更多内容即将发布,敬请期待! 👀

✍️ LLM应用中的集成

此MCP服务器可与任何支持以下功能的LLM应用程序配合使用 工具. 我已经在支持轻松一键安装的Claude Desktop App上进行了端到端验证。

使用DXT文件在Claude桌面应用程序中安装

  1. 下载最新 emsesp-mcp-server.dxt 文件
  2. 打开 Settings 在克劳德桌面
  3. 首选 Extensions 并将DXT文件拖动到窗口中
  4. 按 Install
  5. 必要时更改EMS-ESP网关的URL
  6. 关上窗户,开始和你的热泵聊天💬

手动安装

例如,转到LLM应用程序的设置文件 .vscode/mcp.json 对于Github Copilot,添加以下配置:

"emsesp": {
  "type": "stdio",
  "command": "npx",
  "args": [
    "-y",
    "github:bosch-buderus-wp/emsesp-mcp-server"
  ],
  "env": {
    "EMS_ESP_URL": "http://ems-esp"
  }
}

⚙️ 配置

  • LOG_LEVEL (info):写入的日志的日志级别 ~/.emsesp mcp/server-%DATE%.log
  • EMS_ESP_URL (http://ems-esp):EMS-ESP网关的基本URL
  • ENTITIES_CONFIG_PATH (./entities.json):实体配置文件的路径
  • TAGS_AS_TOOLS (统计数据、温度、状态、设置、泵、加热器):逗号分隔的标签列表。每个标签都作为一个单独的工具暴露出来。每个工具都提供了存储在以下位置的配置文件中标记有相应标签的所有实体 ENTITIES_CONFIG_PATH.

🛠️ 可用工具

当前初始版本中的MCP服务器提供只读 工具 LLM可以根据需要选择。 为了减少响应中的令牌大小并减少响应中不相关的噪声,EMS-ESP提供的庞大实体列表已被减少到有意义的最小值,并与类似类别的实体分组,如 统计 或 温度. 为了支持LLM选择正确的工具并正确解释响应——希望尽可能少地产生幻觉,工具和返回的实体都得到了很好的描述。

EMS-ESP的每个实体都有一个列表 tags 在……里面 entity.json:

"dhw.nrg": {
      "title": "Total heat energy generated for hot water",
      "tags": ["statistics", "energy", "dhw", "prod-nrg"]
    },

与标签关联的所有实体都会通过相应的MCP工具暴露出来。

如果要添加更多实体,请复制 entity.json 并添加您的其他实体。 然后,您可以通过环境变量在MCP服务器中使用修改后的文件 ENTITIES_CONFIG_PATH=<修改文件的路径>。

👓 展望

  • 更多实体和提示
  • 设置室温、开始消毒、启用PV剩余、调整dhw设置的工具。..
  • 提供更多主题背景的资源

📄 许可证

麻省理工学院