힙합

Home Assistant와 상호 작용하는 모델 Context Protocol (MCP) 서버. 이 서버는 MCP-enabled 응용 프로그램을 통해 홈 보조 장치를 제어하고 모니터링하는 도구를 제공합니다.

이 프로젝트는 AI Model Context Protocol (MCP) 생태계의 일부입니다. MCP 도구에 대한 자세한 내용은 www.aimcp.info를 참조하십시오.

특징

• 장치 상태를 얻기
• 제어 장치 상태 (on/off)
• 방아쇠 자동화
• 목록 사용 가능

설치

Smithery를 통해 설치

Home Assistant MCP Server

🌟 Sponsors

A Model Context Protocol (MCP) server for interacting with Home Assistant. This server provides tools to control and monitor your Home Assistant devices through MCP-enabled applications.

This project is part of the AI Model Context Protocol (MCP) ecosystem. For more information and documentation about MCP tools, visit www.aimcp.info.

Features

• Get device states
• Control device states (on/off)
• Trigger automations
• List available entities

Installation

Installing via Smithery

To install Home Assistant MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude

Manual Installation

1. Clone this repository:

git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Configure the MCP server by adding the following to your MCP settings file (typically located at ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json for VSCode):

{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

Replace your-homeassistant-url and your-long-lived-access-token with your Home Assistant instance URL and access token.

Usage

The server provides the following tools:

1. Get Device State

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {