infra-mcp
infra-mcp
MCP server that gives Claude Code real-time visibility into local infrastructure — Docker containers and system health.
Tools
System (8 tools)
Tool | Description |
| CPU load, memory, uptime |
| NVIDIA GPU utilization and VRAM |
| Processes using the GPU |
| Filesystem usage |
| PSI metrics for I/O pressure |
| Top processes by CPU/memory |
| systemd service status |
| Detailed memory breakdown |
Docker (7 tools)
Tool | Description |
| List all containers with status |
| Detailed container info |
| Tail container logs |
| Start a stopped container |
| Stop a running container |
| Restart a container |
| Docker Compose project status |
Setup
npm installUsage
npm startConfigure in Claude Code MCP settings:
{
"mcpServers": {
"infra": {
"command": "node",
"args": ["/path/to/infra-mcp/index.js"]
}
}
}Configuration
Env Variable | Default | Description |
|
| Docker socket path |
|
| Path to nvidia-smi binary |
Tech Stack
Node.js (>=18)
@modelcontextprotocol/sdkDocker API v1.43 (Unix socket)
/procfilesystem for system metricsnvidia-smifor GPU monitoring