Zencontrol Tpi

Remote MCP tool servers for zencontrol TPI Classic and TPI Advanced, packaged for Docker with SSE transport and Cloudflare Tunnel exposure for Hermes agents.

Tools

Tool	Classic	Advanced
dali_dim	Yes	Yes
dali_full_on	Yes	Yes
dali_off	Yes	Yes
query_control_gear_fault_status	—	Yes
query_group_status	—	Yes

Quick start (local)

cd zencontrol-mcp
cp .env.example .env
# Edit ZENCONTROL_HOST and MCP_AUTH_TOKEN

pip install fastmcp mcp pydantic starlette uvicorn pytest
set PYTHONPATH=packages

python servers/classic/server.py   # port 8101
python servers/advanced/server.py  # port 8102

Docker

docker compose up -d
curl http://127.0.0.1:8101/health
curl -N -H "Authorization: Bearer YOUR_TOKEN" http://127.0.0.1:8101/sse

Cloudflare Tunnel + Hermes

See deploy/cloudflared/README.md and deploy/hermes-config.example.yaml.

Docker MCP catalog

docker mcp catalog create zencontrol-catalog
docker mcp catalog add zencontrol-catalog zencontrol-tpi-classic ./servers/classic/catalog-entry.yaml
docker mcp catalog add zencontrol-catalog zencontrol-tpi-advanced ./servers/advanced/catalog-entry.yaml

Tests

set PYTHONPATH=packages
pytest tests/