ampio-mcp-agent
v0.7.6
Published
Agent of Ampio MCP: relays an Ampio installation (M-SERV over MQTT) to the Ampio MCP server so Claude can program its logic.
Maintainers
Readme
ampio-mcp-agent
The agent of Ampio MCP: run it on the network of an Ampio installation and Claude can read and program its logic. It connects to the M-SERV over MQTT and keeps one outbound connection to the Ampio MCP server — no open ports. It relays only the requests the server is allowed to make; MQTT (and Node-RED) credentials stay with it.
Requires Node.js 24 or newer. The Docker image ghcr.io/aii-gee/ampio-mcp-agent is the same agent.
SERVER_URL=https://ampio-mcp.aiigee.pl \
AGENT_NAME=ampio-agent-home AGENT_LANG=en \
MQTT_HOST=192.168.1.50 MQTT_USER=admin MQTT_PASSWORD=... \
npx -y ampio-mcp-agent@latestOn first start it prints a pairing code: enter it in the panel (Add installation). Its token is kept in ~/.ampio-mcp-agent/agent-token (TOKEN_FILE to change). Keep it running as a service (systemd, pm2, …).
| variable | |
|---|---|
| SERVER_URL | the Ampio MCP server |
| MQTT_HOST, MQTT_USER, MQTT_PASSWORD | the M-SERV's MQTT broker |
| AGENT_NAME | shown in the panel (default: the host name) |
| AGENT_LANG | en or pl: the agent's messages and the language Claude names things in for this installation |
| NODERED_URL | Node-RED (default http://MQTT_HOST:1880; off turns the connector off); NODERED_TOKEN, or NODERED_USER + NODERED_PASSWORD with adminAuth |
| TOKEN_FILE | where the agent token is kept |
License: proprietary, all rights reserved — see LICENSE. You may run this agent only to connect installations you own or manage to the Ampio MCP service.
