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 | |------|-------------| | system_overview | CPU load, memory, uptime | | gpu_status | NVIDIA GPU utilization and VRAM | | gpu_processes | Processes using the GPU | | disk_usage | Filesystem usage | | io_pressure | PSI metrics for I/O pressure | | top_processes | Top processes by CPU/memory | | service_status | systemd service status | | memory_detail | Detailed memory breakdown |
Docker (7 tools)
| Tool | Description | |------|-------------| | list_containers | List all containers with status | | inspect_container | Detailed container info | | container_logs | Tail container logs | | start_container | Start a stopped container | | stop_container | Stop a running container | | restart_container | Restart a container | | compose_status | 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_HOST | /var/run/docker.sock | Docker socket path | | NVIDIA_SMI_PATH | nvidia-smi | Path to nvidia-smi binary |
Tech Stack
- Node.js (>=18)
@modelcontextprotocol/sdk- Docker API v1.43 (Unix socket)
/procfilesystem for system metricsnvidia-smifor GPU monitoring
