Mcp Homeassistant

io.github.daedalus由 GitHub 帳號 daedalus 發布v0.1.0更新於 Oct 24, 2026

MCP server exposing Home Assistant REST API functionality

已驗證STDIO僅桌面位置與生活效率與工作流

概覽

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 中

  1. 開啟 儀表板中的 Mcp Homeassistant,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mcp-homeassistant

MCP server exposing Home Assistant 2026.4.1 REST API functionality.

[PyPI] [Python] [Ruff]

mcp-name: io.github.daedalus/mcp-homeassistant

Install

bash
pip install mcp-homeassistant

Configuration

Set the following environment variables:

  • HA_URL: Home Assistant URL (default: http://localhost:8123)
  • HA_TOKEN: Long-Lived Access Token (required)

Usage

bash
export HA_URL="http://homeassistant:8123"export HA_TOKEN="your_long_lived_access_token"mcp-homeassistant

Tools

The MCP server exposes the following tools:

  • get_api_status - Check if the API is running
  • get_config - Get HA configuration
  • get_components - List loaded components
  • get_events - List event types and listener counts
  • get_services - List available services by domain
  • get_states - Get all entity states
  • get_state - Get a specific entity state
  • set_state - Update or create an entity state
  • delete_state - Delete an entity state
  • fire_event - Fire a custom event
  • call_service - Call a Home Assistant service
  • render_template - Render a Jinja template
  • get_history - Get historical state changes
  • get_logbook - Get logbook entries
  • check_config - Validate configuration.yaml
  • handle_intent - Handle an intent
  • get_error_log - Get error log
  • get_calendars - List calendar entities
  • get_calendar_events - Get calendar events

Resources

  • homeassistant://config - Current config
  • homeassistant://states - All entity states
  • homeassistant://services - Available services
  • homeassistant://components - Loaded components

Development

bash
git clone https://github.com/daedalus/mcp-homeassistant.gitcd mcp-homeassistantpip install -e ".[test]"
# run testspytest
# formatruff format src/ tests/
# lintruff check src/ tests/
# type checkmypy src/

來源:README.md,提交 330dcaf

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分