2025.3.4
首页 ▸ Integrations ▸

Model Context Protocol

The Model Context Protocol is an open protocol that standardizes how applications provide context to LLMs. The Model Context Protocol integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] enables using MCP Servers in Home Assistant for providing additional tools to use with a conversation agent. For example, you can add an MCP server that supports memory functionality, or that can search the web using functionality not already available in Home Assistant.

Controlling Home Assistant is done by providing MCP clients access to the Assist API of Home Assistant. You can control what devices and entities it can access from the exposed entities page.

Prerequisites

  1. You will need an MCP server.
  2. If your MCP server only supports the stdio protocol, you will also need an additional MCP proxy (such as mcp-proxy) to expose the server over SSE.

配置

要将 Model Context Protocol integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务。

  • 在右下角，选择 Add Integration 按钮。

  • 从列表中选择 Model Context Protocol。

  • 按照屏幕上的说明完成设置。

Configuration options

The integration provides the following configuration options:

SSE Server URL

The URL for the SSE endpoint of the MCP server. For example, http://example/sse.

Architecture overview

This integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] can provide additional functionality for LLM conversation agents (for example Anthropic, Google Generative AI, Ollama, Open AI).

Home Assistant acts as a client to the MCP server you specify. Home Assistant will poll the MCP server SSE endpoint and query the list of available tools. The tools are made available for use by Home Assistant conversation agents, similar to the Assist API. See the Model Context Protocol Introduction for more details on the protocol.

The Home Assistant Model Context Protocol integration acts as a client using the Server-Sent Events (SSE) transport allowing streaming client-to-server communication. Most MCP clients today only support stdio transport, and directly run an MCP server as a local command line tool. You can use an MCP proxy server like mcp-proxy to enable Home Assistant to access an MCP SSE server.

Once the integration is configured, you also need to configure the conversation agent to use the tools.

Supported functionality

Tools

MCP Tools enable LLMs to perform actions through Home Assistant. The tools used by the configured LLM API are exposed.

Known limitations

The Home Assistant Model Context Protocol integration currently only supports a subset of MCP features:

Feature Supported by Home Assistant
Prompts ❌
Tools ✅
Resources ❌
Sampling ❌
Notifications ❌

Troubleshooting

See Model Context Protocol: Debugging for general tips on debugging MCP. If you are developing your own MCP server and having trouble making it work with Home Assistant, you can also use the MCP Inspector to verify that your MCP server is working correctly.

Remove integration

This integration can be removed by following these steps:

从Home Assistant中移除集成实例

  1. 前往 设置 > 设备与服务 并选择集成卡片。
  2. 从设备列表中，选择要删除的集成实例。
  3. 在条目旁边，选择三个点 菜单。然后，选择 删除。

相关主题