{
  "markdown": "# mcp-podman-crunchtools\n\n<!-- mcp-name: io.github.crunchtools/podman -->\n\nMCP 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.\n\n## Installation\n\n```bash\n# uvx (zero-install)\nuvx mcp-podman-crunchtools\n\n# pip\npip install mcp-podman-crunchtools\n\n# Container\npodman run -v /run/podman/podman.sock:/run/podman/podman.sock:z \\\n  --security-opt label=type:container_runtime_t \\\n  quay.io/crunchtools/mcp-podman\n```\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `PODMAN_SOCKET` | No | Auto-detect | Unix socket path |\n| `PODMAN_SOCKET_FILE` | No | — | File containing socket path |\n| `PODMAN_TIMEOUT` | No | 30 | Request timeout in seconds |\n\nSocket auto-detection order:\n1. `$XDG_RUNTIME_DIR/podman/podman.sock` (rootless)\n2. `/run/user/$UID/podman/podman.sock` (rootless fallback)\n3. `/run/podman/podman.sock` (rootful)\n\n## Claude Code Integration\n\n```bash\nclaude mcp add mcp-podman-crunchtools \\\n  --env PODMAN_SOCKET=/run/podman/podman.sock \\\n  -- uvx mcp-podman-crunchtools\n```\n\n## Tools (30)\n\n### Containers (12)\n| Tool | Description |\n|------|-------------|\n| `container_list` | List containers |\n| `container_inspect` | Get container details |\n| `container_start` | Start a container |\n| `container_stop` | Stop a container |\n| `container_restart` | Restart a container |\n| `container_kill` | Send signal to container |\n| `container_rm` | Remove a container |\n| `container_logs` | Get container logs |\n| `container_top` | List processes |\n| `container_stats` | Resource usage |\n| `container_create` | Create a container |\n| `container_prune` | Remove stopped containers |\n\n### Images (5)\n| Tool | Description |\n|------|-------------|\n| `image_list` | List images |\n| `image_inspect` | Get image details |\n| `image_pull` | Pull from registry |\n| `image_rm` | Remove an image |\n| `image_prune` | Remove unused images |\n\n### Pods (7)\n| Tool | Description |\n|------|-------------|\n| `pod_list` | List pods |\n| `pod_inspect` | Get pod details |\n| `pod_start` | Start a pod |\n| `pod_stop` | Stop a pod |\n| `pod_restart` | Restart a pod |\n| `pod_rm` | Remove a pod |\n| `pod_create` | Create a pod |\n\n### Networks (2)\n| Tool | Description |\n|------|-------------|\n| `network_list` | List networks |\n| `network_inspect` | Get network details |\n\n### Volumes (2)\n| Tool | Description |\n|------|-------------|\n| `volume_list` | List volumes |\n| `volume_inspect` | Get volume details |\n\n### System (2)\n| Tool | Description |\n|------|-------------|\n| `system_info` | Podman system info |\n| `system_df` | Disk usage |\n\n## License\n\nAGPL-3.0-or-later\n",
  "bytes": 2735,
  "sha": "5272911b05574b7432081107b50d47f4fb9dfcae2019a45a167cce16aa125599",
  "repo_slug": "crunchtools/mcp-podman",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_crunchtools_podman_40ae5a82/readme"
}