** 다운로드 c4mcp.c4z**

Control4 DriverWorks 드라이버는 HTTP에서 Model Context Protocol (MCP)을 통해 스마트 홈을 노출시킵니다. 어떤 MCP 호환 AI 클라이언트 - Claude Code, Claude Desktop, OpenClaw, etc. — 당신의 관제사에 당신의 가정을 자연 언어로 통제하십시오.

** 필요 **: Control4 OS 3.3.0+. 컨트롤러의 HTTPS 인증서를 생성하면 OS 3.4.1+가 필요합니다.

그것은 무엇을

• Control4 컨트롤러에서 MCP 서버를 직접 실행합니다. - 외부 서버가 필요하지 않습니다.
• 표준 MCP 도구를 통해 장치 상태, 룸 레이아웃 및 제어 노출
• 지원 빛, 보온장치, 장님, 자물쇠, 릴레이, 감지기, 경험 단추 및 더 많은 것
• 객실 중심 미디어 컨트롤 - 재생/쉼, 볼륨, 소스 선택, 방송 오디오 스테이션, 멀티 룸 세션
• LAN 보안용 Bearer 토큰 인증
• HTTP 및 HTTPS 전송

빠른 시작

1. 다운로드 c4mcp.c4z (또는 소스에서 빌드 - 건물 참조)
2. Composer Pro를 통해 컨트롤러에 c4mcp.c4z를 설치 (제어기 아래 연구)
3. 드라이버의 Actions 탭으로 이동하고 Generate API Key 를 누르고 Write 스코프 선택 (독서만 볼 수 있습니다; 전체 장치 프로필을 편집 할 수 있습니다).

C4MCP — Control4 MCP Server

Download c4mcp.c4z

A Control4 DriverWorks driver that exposes your smart home via the Model Context Protocol (MCP) over HTTP. Point any MCP-compatible AI client — Claude Code, Claude Desktop, OpenClaw, etc. — at your controller and control your home with natural language.

Requires: Control4 OS 3.3.0+. Generating the HTTPS certificate on the controller requires OS 3.4.1+.

What It Does

• Runs an MCP server directly on the Control4 controller — no external server needed
• Exposes device state, room layout, and control via standard MCP tools
• Supports lights, thermostats, blinds, locks, relays, sensors, experience buttons, and more
• Room-centric media control — play/pause, volume, source selection, broadcast audio stations, multi-room sessions
• Bearer token authentication for LAN security
• HTTP and HTTPS transport

Quick Start

1. Download c4mcp.c4z (or build from source — see Building)
2. Install c4mcp.c4z on your controller via Composer Pro (search under Controllers)
3. Go to the driver’s Actions tab and press Generate API Key, entering a name and choosing the Write scope (Read can only view; Full can also edit Device Profiles). Copy the key from the Last Generated Key property (auto-clears after 30s)
4. Configure your MCP client to connect to http://:9201/mcp with the API key as a Bearer token

See the full documentation for client configuration examples, HTTPS setup, device profiles, troubleshooting, and more.

Building

Requires DriverPackager and DriverValidator (Windows/WSL) in PATH.

make build    # Build c4mcp.c4z
make clean    # Remove build artifacts

Install the resulting c4mcp/build/c4mcp.c4z on your controller via Composer Pro.

Project Structure

c4mcp/
├── driver.lua            # Entry point
├── driver.xml            # Driver manifest
├── c4mcp.c4zproj         # Build project file
├── modules/
│   ├── mcp_server.lua    # MCP JSON-RPC protocol handler
│   ├── http_server.lua   # Raw TCP → HTTP server
│   ├── server.lua        # Server lifecycle (HTTP/HTTPS)
│   ├── auth.lua          # API key authentication
│   ├── c4_home.lua       # Smart home data layer
│   ├── c4_media.lua      # Media status and control
│   ├── control.lua       # Device control dispatch
│   ├── device_config.lua # Custom device profiles
│   └── device_types.lua  # Per-type control handlers
└── www/
    └── documentation.html     # Full documentation

License

MIT