Infra

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 install

Usage

npm start

Configure 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)
• /proc filesystem for system metrics
• nvidia-smi for GPU monitoring