mcmqtt/CLAUDE.md

mcMQTT

MCP server for MQTT broker interaction and IoT messaging. Allows LLMs to publish, subscribe, and manage MQTT topics.

• Docs: https://mcmqtt.warehack.ing
• Git: git@git.supported.systems:MCP/mcmqtt.git
• Server: ssh -A warehack-ing@warehack.ing, repo at ~/mcmqtt

Docs Site Deployment

Starlight documentation site in docs-site/ subdirectory.

Environment

Copy .env.example to .env in docs-site/:

COMPOSE_PROJECT_NAME=mcmqtt-docs
DOMAIN=mcmqtt.warehack.ing

Commands

# From docs-site/ directory:
make up        # Build and start production container
make down      # Stop container
make logs      # Tail container logs
make restart   # Stop + start

Deploy to Production

ssh -A warehack-ing@warehack.ing "cd ~/mcmqtt && git pull && cd docs-site && make up"