
Mcp Homeassistant
io.github.daedalus由 GitHub 帳號 daedalus 發布v0.1.0更新於 Oct 24, 2026
MCP server exposing Home Assistant REST API functionality
概覽
AI 產生的概覽
一個本機 MCP 伺服器,透過 Home Assistant 的 REST API 讓助理檢視並控制智慧家庭實體、服務、事件與行事曆
- 可以做什麼
- 檢查 API 狀態、設定、已載入元件、事件類型與依網域列出的可用服務,讀取全部實體狀態或單一實體狀態,並以資源形式提供目前設定、狀態、服務與元件。建立、更新或刪除實體狀態,觸發自訂事件並呼叫 Home Assistant 服務。轉譯 Jinja 範本並處理意圖。取得歷史狀態變更、日誌簿項目、錯誤日誌以及行事曆實體與事件。驗證設定檔。
- 適用情境
- 適合在桌面上讓助理查詢或控制 Home Assistant 智慧家庭環境,例如讀取感測器狀態、檢視歷史與日誌,或觸發服務與事件。
- 執行需求
- 以本機 Python 程序執行,從 PyPI 安裝(pip install mcp-homeassistant)。需要透過環境變數 HA_URL 提供可連線的 Home Assistant 位址(預設 HA_TOKEN 中提供長期存取權杖(必填)。需要能連線至該 Home Assistant 執行個體的網路。
安裝前請注意
HA_TOKEN 長期存取權杖是權限很大的憑證,可存取 Home Assistant API,應妥善保密。多個工具會寫入或變更資料:set_state 與 delete_state 修改實體狀態,fire_event 發出事件,call_service 可能觸發真實裝置動作,例如門鎖、暖氣或警報。讓助理執行前請先確認這些操作。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Mcp Homeassistant,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
mcp-homeassistant
MCP server exposing Home Assistant 2026.4.1 REST API functionality.
mcp-name: io.github.daedalus/mcp-homeassistant
Install
Configuration
Set the following environment variables:
HA_URL: Home Assistant URL (default: http://localhost:8123)HA_TOKEN: Long-Lived Access Token (required)
Usage
Tools
The MCP server exposes the following tools:
get_api_status- Check if the API is runningget_config- Get HA configurationget_components- List loaded componentsget_events- List event types and listener countsget_services- List available services by domainget_states- Get all entity statesget_state- Get a specific entity stateset_state- Update or create an entity statedelete_state- Delete an entity statefire_event- Fire a custom eventcall_service- Call a Home Assistant servicerender_template- Render a Jinja templateget_history- Get historical state changesget_logbook- Get logbook entriescheck_config- Validate configuration.yamlhandle_intent- Handle an intentget_error_log- Get error logget_calendars- List calendar entitiesget_calendar_events- Get calendar events
Resources
homeassistant://config- Current confighomeassistant://states- All entity stateshomeassistant://services- Available serviceshomeassistant://components- Loaded components
Development
來源:README.md,提交 330dcaf
工具
0SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。
版本歷史
1- v0.1.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分