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

📔 Table of Contents

• About
• Integration in LLM Application
• Configuration
• Available Tools
• Outlook

🚀 About

With this Model Context Protocol (MCP) server, you can integrate your Bosch CS5800/6800i or Buderus WLW176/186i heat pump via ems-esp into a Large Language Model (LLM) Application such as Claude Desktop.

Then shoot your prompts like so:

• Is hot water preparation running right now?
• What's the current outdoor temperature?
• How warm is the domestic hot water at the moment?
• How much electricity is my heat pump currently using?
• What's the COP (Coefficient of Performance) for hot water preparation?

The LLM will select the necessary Tools provided by the MCP server to answer the question.

Or you can simply use the built-in Prompts provided by the MCP server:

• /show-dhw-settings to get all settings for domestic hot water preparation in table format
• /show-heat-curve to show the configured heat curve as a graph
• ... more to come soon - stay tuned! 👀

✍️ Integration in LLM Application

This MCP server works with any LLM application which supports Tools. I've verified it end-to-end on the Claude Desktop App which supports easy one-click installation.

Install in Claude Desktop App with DXT file

1. Download latest emsesp-mcp-server.dxt file
2. Open Settings in Claude Desktop
3. Go to Extensions and drag the DXT file into the window
4. Press Install
5. Change the URL of your EMS-ESP gateway if necessary
6. Close the window and start chatting with your heat pump 💬

Manual installation

Go to the settings file of your LLM application, for instance .vscode/mcp.json for Github Copilot, and add the following configuration:

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

⚙️ Configuration

• LOG_LEVEL (info): The log level of the logs which get written to ~/.emsesp-mcp/server-%DATE%.log
• EMS_ESP_URL (http://ems-esp): Base URL of the EMS-ESP gateway
• ENTITIES_CONFIG_PATH (./entities.json): Path to the entity configuration file
• TAGS_AS_TOOLS (statistics,temperatures,states,settings,pumps,eheater): comma-separated list of tags. Each tag gets exposed as a separate tool. Each tool provides all entities which are tagged with the respective tag in the config file stored at ENTITIES_CONFIG_PATH.

... View full README on GitHub