Mcp 服务器家庭助理

什么是 Home Assistant 的 MCP 服务器？

Home Assistant 的 MCP 服务器是一个专门设计的服务器，旨在促进模型上下文协议（MCP）在 Home Assistant 生态系统中的集成。该服务器充当桥梁，使各种智能家居设备与 Home Assistant 平台之间能够无缝通信，从而增强自动化和控制能力。

Home Assistant 的 MCP 服务器功能

• 与 Home Assistant 集成：MCP 服务器允许与 Home Assistant 轻松集成，为用户提供统一的界面来管理他们的智能家居设备。
• 实时通信：它支持实时数据交换，确保命令和更新能够即时处理，这对于时间敏感的应用至关重要。
• 用户友好的界面：该服务器具有简单的设置过程和直观的用户界面，使其即使对技术知识有限的人也能轻松访问。
• 开源：作为一个开源项目，用户可以为其开发做出贡献，根据自己的需求进行定制，甚至可以分叉用于个人使用。
• 社区支持：MCP 服务器受益于一个充满活力的用户和开发者社区，他们提供支持、分享经验并为其持续改进做出贡献。

如何设置 Home Assistant 的 MCP 服务器

1. 安装：首先从其 GitHub 仓库下载 MCP 服务器。按照文档中提供的安装说明进行操作。
2. 配置：安装完成后，配置服务器设置以匹配您的 Home Assistant 设置。这可能包括设置网络参数和设备连接。
3. 集成：将 MCP 服务器添加到您的 Home Assistant 配置中。通常涉及编辑 configuration.yaml 文件以包含 MCP 集成。
4. 测试：配置完成后，测试服务器以确保它与您的 Home Assistant 设置和连接的设备有效通信。
5. 自定义：探索其他功能和自定义选项，以根据您的特定智能家居需求调整服务器。

常见问题解答

问：MCP 服务器与所有智能家居设备兼容吗？

答：MCP 服务器设计用于与广泛的智能家居设备配合使用，但兼容性可能有所不同。请查看文档以获取支持设备的列表。

问：我可以为 MCP 服务器项目做贡献吗？

答：可以！MCP 服务器是一个开源项目，欢迎贡献。您可以通过 GitHub 仓库报告问题、建议功能或提交代码改进。

问：运行 MCP 服务器的系统要求是什么？

答：MCP 服务器可以在多种平台上运行，包括 Raspberry Pi 和其他基于 Linux 的系统。请参考安装指南以获取具体要求。

问：我该如何排查与设备的连接问题？

答：如果遇到连接问题，请检查服务器日志中的错误消息，确保您的设备已开机并连接到同一网络，并验证您的配置设置。

问：是否有移动应用程序用于管理 MCP 服务器？

答：目前没有专门的移动应用程序，但一旦集成，您可以通过 Home Assistant 移动应用程序管理 MCP 服务器。

mcp-server-home-assistant

A Model Context Protocol Server for Home Assistant. See Model Context Protocol for context.

The custom component required by this integration is moving to Home Assistant Core in https://github.com/home-assistant/core/pull/134122

Usage in Claude Desktop

1. Install the home-assistant-model-context-protocol custom component in your Home Assistant instance

2. Create a Long Lived Access Token

3. Clone this git repo to a path like /Users/allen/Development/mcp-server-home-assistant

4. Edit your claude_desktop_config.json with something like this and include your home assistant url and api token:

   {
       "mcpServers": {
           "Home-assistant": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/Users/allen/Development/mcp-server-home-assistant",
                   "run",
                   "mcp-server-home-assistant",
                   "-v",
                   "-v"
               ],
               "env": {
                   "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket",
                   "HOME_ASSISTANT_API_TOKEN": "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9.....
               }
           }
       }
   }
   

5. You can view the logs e.g. ~Library/Logs/Claude/mcp-server-Home-assistant.log to understand what is happening