loxone-mcp

Loxone Miniserver 스마트 홈 시스템을 AI 어시스턴트에 연결하는 MCP(Model Context Protocol) 서버입니다.

Claude(또는 MCP 호환 AI)가 방 목록을 확인하고, 실시간 센서/액추에이터 상태를 조회하며, 장치를 검색하고, 명령을 보낼 수 있게 합니다.

기능

• list_rooms — 제어 장치가 포함된 모든 방 목록

• list_controls — 모든 제어 장치(이름, 유형, UUID, 방)

• find_control — 이름/방/유형을 통한 키워드 검색

• get_status — 실시간 센서 및 액추에이터 값(선택적 방 필터)

• control_device — 명령 전송(켜기/끄기, 밝기 %, 블라인드, HVAC, 오디오)

Related MCP server: Loxone MCP Server

요구 사항

• Cloud Connect가 활성화된 Loxone Miniserver

• Node.js 20+ (또는 Docker)

설치

npm

npm install -g @syntropic/loxone-mcp

그런 다음 환경 변수를 설정하고 실행합니다:

LOXONE_SERIAL=XXXXXXXXXXXX \
LOXONE_USER=admin \
LOXONE_PASS=yourpass \
MCP_API_KEY=$(openssl rand -hex 32) \
loxone-mcp

소스에서 설치

git clone https://github.com/syntropicsignal-ai/loxone-mcp.git
cd loxone-mcp
cp .env.example .env
# edit .env with your Miniserver serial, credentials, and a random API key
npm install
npm run build
npm start

서버는 http://localhost:3000에서 수신 대기합니다. MCP 엔드포인트는 POST /mcp입니다.

Docker

docker build -t loxone-mcp .
docker run -p 3000:3000 --env-file .env loxone-mcp

구성

Claude에 연결

Claude MCP 구성에 다음을 추가하세요:

{
  "mcpServers": {
    "loxone": {
      "url": "https://your-server/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

장치 유형별 지원 명령

아키텍처

• 상태 비저장(Stateless) HTTP 서버 — 각 POST /mcp 요청마다 새로운 전송 생성(세션 상태 없음)

• Loxone Cloud Connect: 모든 요청 시 dns.loxonecloud.com을 통해 현재 터널 URL 확인

• 구조 캐시: Loxone 앱 구조(LoxAPP3.json)를 60초 동안 캐시

라이선스

MIT