Skip to main content
Glama
crunchtools

mcp-podman-crunchtools

by crunchtools

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

Related MCP server: Podman MCP Server

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

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/crunchtools/mcp-podman'

If you have feedback or need assistance with the MCP directory API, please join our Discord server