Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Podman Crunchtools

FreeNot checked

Enables container, image, pod, network, volume, and system management via Podman REST API. Supports rootful and rootless Podman operations.

GitHubEmbed

About

Enables container, image, pod, network, volume, and system management via Podman REST API. Supports rootful and rootless Podman operations.

README

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:

  1. $XDG_RUNTIME_DIR/podman/podman.sock (rootless)
  2. /run/user/$UID/podman/podman.sock (rootless fallback)
  3. /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

from github.com/crunchtools/mcp-podman

Installing Podman Crunchtools

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/crunchtools/mcp-podman

FAQ

Is Podman Crunchtools MCP free?

Yes, Podman Crunchtools MCP is free — one-click install via Unyly at no cost.

Does Podman Crunchtools need an API key?

No, Podman Crunchtools runs without API keys or environment variables.

Is Podman Crunchtools hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Podman Crunchtools in Claude Desktop, Claude Code or Cursor?

Open Podman Crunchtools on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Podman Crunchtools with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All media MCPs