ha-mcp

(★ 4,457)

The Unofficial and Awesome Home Assistant MCP Server

파일 탐색기

최종 버전 다운로드 (.zip)
  • .coderabbit.yaml
  • .dockerignore
  • .env.example
  • .gitattributes
  • .gitignore
  • .gitmodules
  • .python-version
  • AGENTS.md
  • CHANGELOG.md
  • CLAUDE.md
  • CONTRIBUTING.md
  • coverage.json
  • docker-compose.screenshot.yml
  • docker-compose.yml
  • Dockerfile
  • fastmcp-http.json
  • fastmcp-webclient.json
  • fastmcp.json
  • hacs.json
  • lefthook.yml
  • LICENSE
  • MANIFEST.in
  • PRIVACY.md
  • pyproject.toml
  • README.md
  • renovate.json
  • repository.yaml
  • SECURITY.md
  • server.json
  • sgconfig.yml
  • uv.lock

# 설치 가이드

1. 코드 내려받기
git clone https://github.com/homeassistant-ai/ha-mcp

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd ha-mcp

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천
curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh

공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.

curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-linux.sh | sh

공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.

irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex

공식 설치 스크립트를 다운로드해서 바로 실행합니다 (PowerShell). 이 한 줄로 필요한 게 자동으로 설치됩니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.
docker compose -f docker-compose.screenshot.yml up -d --build

compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

4. Node.js

쉬움
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.
cd site

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

5. Python

쉬움
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).
pip install -r src/ha_mcp/_vendor/requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

오늘의 추천 프로젝트

tensorflow ★ 197,088

모두를 위한 오픈소스 머신러닝 프레임워크

C++
JavaGuide ★ 157,804

Java 면접 & 백엔드 공통 면접 가이드, 컴퓨터 기초, 데이터베이스, 분산 시스템, 고동시성(High Concurrency), 시스템 디자인 및 AI 어플리케

JavaScript
gstack ★ 128,249

Garry Tan의 실제 Claude Code 설정을 사용해 보세요: CEO, 디자이너, 엔지니어링 매니저, 릴리스 매니저, 문서 엔지니어, QA 역할을 수행하는

TypeScript
Python-100-Days ★ 185,241

Python - 100天从新手到大师

Jupyter Notebook
gemini-cli ★ 106,532

Gemini의 강력한 성능을 터미널로 직접 가져오는 오픈 소스 AI 에이전트입니다.

TypeScript
learn-claude-code ★ 74,382

Bash는 그 자체로 충분합니다 - 0부터 1까지 직접 구축한, 나노 claude code 스타일의 「agent harness」

Python
// repository documentation