Podman Crunchtools

FreeNot checked

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

by crunchtools

GitHub Embed

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:

$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; environment values are redacted, names kept
`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, with the options of `podman image prune` (`all`, `external`, `build_cache`, `filters`)

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

ARA

Generate images, video and audio from any AI agent — one connector.

by ARA

Omni Video

An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/

by buildwithtaza

YouTube

Transcripts, channel stats, search

by YouTube

EverArt

AI image generation using various models.

by modelcontextprotocol

gpu-bridge/mcp-server

GPU inference API for LLMs, image and video generation, TTS, Whisper, embeddings, reranking and OCR, paid per use via x402 or an API key.

by gpu-bridge

merterbak/Grok-MCP

Access xAI's Grok API with agentic tool calling, image generation, vision and file support.

by merterbak

SureScaleAI/openai-gpt-image-mcp

Image generation and editing with OpenAI's GPT image models.

by SureScaleAI

YangLiangwei/PersonalizationMCP

Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.

by YangLiangwei

AceDataCloud/MCPFlux

Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.

by AceDataCloud

AceDataCloud/MCPNanoBanana

Nano Banana image generation and editing, including virtual try-on and product placement in realistic scenes.