mcp-podman-crunchtools
MCP server for Podman container management via the Podman REST API. Manages containers, images, pods, networks, volumes, and system info. Supports both rootful and rootless Podman.
Installation
# uvx (zero-install)
uvx mcp-podman-crunchtools
# pip
pip install mcp-podman-crunchtools
# Container
podman run -v /run/podman/podman.sock:/run/podman/podman.sock:z \
--security-opt label=type:container_runtime_t \
quay.io/crunchtools/mcp-podman
Configuration
| Variable | Required | Default | Description |
|---|
PODMAN_SOCKET | No | Auto-detect | Unix socket path |
PODMAN_SOCKET_FILE | No | — | File containing socket path |
PODMAN_TIMEOUT | No | 30 | Request timeout in seconds |
Socket auto-detection order:
$XDG_RUNTIME_DIR/podman/podman.sock (rootless)/run/user/$UID/podman/podman.sock (rootless fallback)/run/podman/podman.sock (rootful)
Claude Code Integration
claude mcp add mcp-podman-crunchtools \
--env PODMAN_SOCKET=/run/podman/podman.sock \
-- uvx mcp-podman-crunchtools
Tools (30)
Containers (12)
| Tool | Description |
|---|
container_list | List containers |
container_inspect | Get container details |
container_start | Start a container |
container_stop | Stop a container |
container_restart | Restart a container |
container_kill | Send signal to container |
container_rm | Remove a container |
container_logs | Get container logs |
container_top | List processes |
container_stats | Resource usage |
container_create | Create a container |
container_prune | Remove stopped containers |
Images (5)
| Tool | Description |
|---|
image_list | List images |
image_inspect | Get image details |
image_pull | Pull from registry |
image_rm | Remove an image |
image_prune | Remove unused images |
Pods (7)
| Tool | Description |
|---|
pod_list | List pods |
pod_inspect | Get pod details |
pod_start | Start a pod |
pod_stop | Stop a pod |
pod_restart | Restart a pod |
pod_rm | Remove a pod |
pod_create | Create a pod |
Networks (2)
| Tool | Description |
|---|
network_list | List networks |
network_inspect | Get network details |
Volumes (2)
| Tool | Description |
|---|
volume_list | List volumes |
volume_inspect | Get volume details |
System (2)
| Tool | Description |
|---|
system_info | Podman system info |
system_df | Disk usage |
License
AGPL-3.0-or-later