Mcp 伺服器 家庭助理
概覽
MCP 伺服器是什麼?用於 Home Assistant
MCP 伺服器是專為促進模型上下文協議(MCP)在 Home Assistant 生態系統中的整合而設計的專用伺服器。這個伺服器充當橋樑,使各種智能家居設備與 Home Assistant 平台之間能夠無縫通信,增強自動化和控制能力。
MCP 伺服器的功能
- 與 Home Assistant 的整合:MCP 伺服器允許輕鬆與 Home Assistant 整合,為用戶提供統一的界面來管理他們的智能家居設備。
- 實時通信:它支持實時數據交換,確保命令和更新能夠即時處理,這對於時間敏感的應用至關重要。
- 友好的用戶界面:伺服器具有簡單的設置過程和直觀的用戶界面,即使對於技術知識有限的人也能輕鬆使用。
- 開源:作為一個開源項目,用戶可以參與其開發,根據自己的需求進行自定義,甚至可以分支用於個人使用。
- 社區支持:MCP 伺服器受益於一個充滿活力的用戶和開發者社區,他們提供支持、分享經驗並貢獻於其持續改進。
如何設置 MCP 伺服器用於 Home Assistant
- 安裝:首先從其 GitHub 倉庫下載 MCP 伺服器。按照文檔中提供的安裝說明進行操作。
- 配置:安裝完成後,配置伺服器設置以匹配您的 Home Assistant 設置。這可能包括設置網絡參數和設備連接。
- 整合:將 MCP 伺服器添加到您的 Home Assistant 配置中。這通常涉及編輯 configuration.yaml 文件以包含 MCP 整合。
- 測試:配置後,測試伺服器以確保它能有效地與您的 Home Assistant 設置和連接的設備進行通信。
- 自定義:探索其他功能和自定義選項,以根據您的特定智能家居需求調整伺服器。
常見問題解答
問: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
-
Install the home-assistant-model-context-protocol custom component in your Home Assistant instance
-
Create a Long Lived Access Token
-
Clone this git repo to a path like
/Users/allen/Development/mcp-server-home-assistant
-
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..... } } } }
-
You can view the logs e.g.
~Library/Logs/Claude/mcp-server-Home-assistant.log
to understand what is happening
伺服器配置
{
"mcpServers": {
"mcp-server-home-assistant": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--allenporter--mcp-server-home-assistant--mcp-server-home-assistant",
"mcp-server-home-assistant"
],
"env": {
"HOME_ASSISTANT_WEB_SOCKET_URL": "home-assistant-web-socket-url"
}
}
}
}