maintenant — Claude Code MCP server: install
This MCP server lets an AI agent inspect Docker and Kubernetes health, logs, and alerts when an infrastructure problem needs investigation.
claude mcp add maintenant -- docker run -i --rm ghcr.io/kolapsis/maintenant:1.10.1What maintenant does
maintenant gives an agent an infrastructure view through MCP. It tracks container state, health checks, restart loops, resources, and live logs, then checks HTTP and TCP endpoints, TLS certificates, cron jobs, image updates, and CVEs. Alerts can be acknowledged, while the agent investigates the reported issue. It never changes containers.
The server runs as a single Docker container and reads the Docker socket as ro; Kubernetes support uses read-only RBAC and namespace filtering. Claude Code can connect through a local Docker process or an HTTP endpoint. The UI and API have no built-in authentication, so an exposed port should sit behind a reverse proxy or bind to 127.0.0.1.
What it helps with
- inspect container health and restart loops
- trace an outage through live container logs
- track TLS certificate expiry
- check an endpoint and surface its alert
- review image updates and CVE risk
Example prompts for the agent
- Check the containers and explain why one of them keeps restarting.
- Show the latest logs for the service and inspect its health checks.
- Check TLS certificates, endpoints, and active alerts.
How to install maintenant
1Platform CLI
claude mcp add maintenant -- docker run -i --rm ghcr.io/kolapsis/maintenant:1.10.12Platform CLI: remote server
claude mcp add --transport http maintenant https://{maintenant_host}/mcp1Platform CLI
codex mcp add maintenant -- docker run -i --rm ghcr.io/kolapsis/maintenant:1.10.12Platform CLI: remote server
codex mcp add maintenant --url https://{maintenant_host}/mcp1Config file
{
"mcpServers": {
"maintenant": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kolapsis/maintenant:1.10.1"
]
}
}
}2Config file
{
"mcpServers": {
"maintenant": {
"url": "https://{maintenant_host}/mcp"
}
}
}1Config file
{
"servers": {
"maintenant": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kolapsis/maintenant:1.10.1"
]
}
}
}2Config file
{
"servers": {
"maintenant": {
"type": "http",
"url": "https://{maintenant_host}/mcp"
}
}
}1Platform CLI
gemini mcp add maintenant docker run -i --rm ghcr.io/kolapsis/maintenant:1.10.12Platform CLI: remote server
gemini mcp add -t http maintenant https://{maintenant_host}/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about maintenant
How do I install maintenant in Claude Code?
For a local Docker connection, run claude mcp add maintenant -- docker run -i --rm ghcr.io/kolapsis/maintenant:1.10.1.
What does maintenant do?
It monitors Docker and Kubernetes, exposes container state and logs, checks endpoints and certificates, and lets an AI agent investigate through MCP. Alerts can be acknowledged.
Does maintenant modify containers?
No. It is for monitoring and does not touch containers; the Docker socket is mounted read-only.
