English Français العربية

MCP Podman

Registre officiel Autres

MCP server for Podman container management via the Podman REST API

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package mcp-podman-crunchtools
Claude Code 
claude mcp add mcp-podman -- uvx mcp-podman-crunchtools==0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-podman": {
            "command": "uvx",
            "args": [
                "mcp-podman-crunchtools==0.1.1"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. mcp-podman-crunchtools
  2. Installation
  3. Configuration
  4. Claude Code Integration
  5. Tools (30)
  6. License

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

VariableRequiredDefaultDescription
PODMAN_SOCKETNoAuto-detectUnix socket path
PODMAN_SOCKET_FILENo—File containing socket path
PODMAN_TIMEOUTNo30Request 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)
ToolDescription
container_listList containers
container_inspectGet container details; environment values are redacted, names kept
container_startStart a container
container_stopStop a container
container_restartRestart a container
container_killSend signal to container
container_rmRemove a container
container_logsGet container logs
container_topList processes
container_statsResource usage
container_createCreate a container
container_pruneRemove stopped containers
Images (5)
ToolDescription
image_listList images
image_inspectGet image details
image_pullPull from registry
image_rmRemove an image
image_pruneRemove unused images, with the options of podman image prune (all, external, build_cache, filters)
Pods (7)
ToolDescription
pod_listList pods
pod_inspectGet pod details
pod_startStart a pod
pod_stopStop a pod
pod_restartRestart a pod
pod_rmRemove a pod
pod_createCreate a pod
Networks (2)
ToolDescription
network_listList networks
network_inspectGet network details
Volumes (2)
ToolDescription
volume_listList volumes
volume_inspectGet volume details
System (2)
ToolDescription
system_infoPodman system info
system_dfDisk usage

License

AGPL-3.0-or-later

Questions fréquentes

Qu'est-ce que MCP Podman ?

MCP server for Podman container management via the Podman REST API

Comment installer MCP Podman ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add mcp-podman -- uvx mcp-podman-crunchtools==0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour MCP Podman ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

MCP Podman est-il open source ?

Oui. Son code est sur GitHub sous licence AGPL-3.0.

Qui maintient MCP Podman ?

Il est publié par crunchtools. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.