emsesp微控制器外设服务器

<div align="center"> <img src="images/logo.png" alt="Logo" width="100" height="100"> <h2>Bosch/Buderus热泵的MCP服务器</h2> <p>用于您的热泵的基于大语言模型的聊天服务</p>

</div>

---

<div align="center"> <img src="https://gips3.baidu.com/it/u=713889040,4164210923&fm=3081&app=3081&f=GIF?w=800&h=654" width="672" alt="获取热水温度和准备COP" /> <p>获取热水温度和准备COP</p> </div>

---

<div align="center"> <img src="https://gips3.baidu.com/it/u=1532472507,2010977043&fm=3081&app=3081&f=GIF?w=672&h=378" alt="获取配置的热量曲线图" /> <p>获取配置的热量曲线图</p> </div>

📔 目录

• 关于
• 在LLM应用中的集成
• 配置
• 可用工具
• 展望

🚀 关于

通过这个**模型上下文协议（MCP）服务器，您可以将Bosch CS5800/6800i或Buderus WLW176/186i热泵**通过ems-esp集成到一个大型语言模型（LLM）应用，如Claude Desktop中。

然后可以像这样发送提示：

• 热水制备现在是否运行？
• 当前室外温度是多少？
• 目前家庭热水的温度是多少？
• 我的热泵当前使用多少电？
• 热水制备的COP（性能系数）是多少？

大语言模型会根据问题选择由MCP服务器提供的必要工具来回答问题。

或者您可以简单地使用MCP服务器提供的内置提示：

• /show-dhw-settings以表格形式获取所有家庭热水制备设置
• /show-heat-curve显示配置的热量曲线图
• ...更多即将推出 - 请继续关注！👀

✍️ 在LLM应用中的集成

此MCP服务器与支持工具的任何LLM应用兼容。我已在支持一键安装的Claude Desktop应用上进行了端到端验证。

使用DXT文件在Claude Desktop应用中安装

1. 下载最新的emsesp-mcp-server.dxt文件
2. 打开Claude Desktop中的设置
3. 转至扩展并拖动DXT文件到窗口中
4. 点击安装
5. 如有必要，请更改EMS-ESP网关的URL
6. 关闭窗口并开始与您的热泵聊天 💬

手动安装

转到您的LLM应用的设置文件，例如GitHub Copilot的.vscode/mcp.json，并添加以下配置：

"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 (statistics,temperatures,states,settings,pumps,eheater): 逗号分隔的标签列表。每个标签都会作为单独的工具暴露出来。每个工具提供配置文件中带有相应标签的所有实体，该配置文件存储在ENTITIES_CONFIG_PATH指定的位置。

🛠️ 可用工具

当前初始版本的MCP服务器提供了只读工具，这些工具可以根据大语言模型的需求进行选择。 为了减少响应中的令牌大小和无关噪声，由EMS-ESP提供的大量实体已被缩减到有意义的最小值，并被组织成类似统计或温度等类别的实体组。 为了帮助大语言模型正确选择合适的工具并解释响应，尽量减少幻觉，工具及其返回的实体都有很好的描述。

每个EMS-ESP实体在entity.json中都有一个tags列表：

"dhw.nrg": {
      "title": "为热水生成的总热量",
      "tags": ["statistics", "energy", "dhw", "prod-nrg"]
    },

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

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

👓 展望

• 更多实体和提示
• 设置房间温度、启动消毒、启用光伏盈余、调整热水设置等工具
• 提供更多主题背景资源

📄 许可证

MIT