MCP Podman

io.github.crunchtools由 GitHub 帳號 crunchtools 發布v0.1.1更新於 Oct 24, 2026

MCP server for Podman container management via the Podman REST API

已驗證STDIO僅桌面雲端與基礎設施開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理透過 Podman REST API 管理 Podman 容器、映像、Pod、網路和磁碟區。

可以做什麼
列出、檢查、建立、啟動、停止、重新啟動、終止、刪除和清理容器，並讀取日誌、程序與資源用量。列出、檢查、拉取、刪除和清理映像。列出、檢查、建立、啟動、停止、重新啟動和刪除 Pod。列出和檢查網路與磁碟區。查看 Podman 系統資訊和磁碟用量。
適用情境
當你在同一台機器上執行 Podman，希望助理代為查看或操作容器、Pod、映像和儲存時適用，rootful 和 rootless 模式皆可。
執行需求
以本機 Python 套件（uvx 或 pip）或容器方式執行，需要存取 Podman Unix socket。socket 路徑會自動偵測，也可用 PODMAN_SOCKET 或 PODMAN_SOCKET_FILE 指定；PODMAN_TIMEOUT 可選設定請求逾時。
安裝前請注意
許多工具會改變狀態：啟動、停止、重新啟動、終止、刪除、清理、建立和拉取。清理和刪除可能移除容器、映像和 Pod，拉取映像會佔用網路和磁碟。容器檢查會隱藏環境變數值但保留名稱。能存取 Podman socket 即代表可控制本機容器執行環境。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 MCP Podman，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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

bash
# uvx (zero-install)uvx mcp-podman-crunchtools
# pippip install mcp-podman-crunchtools
# Containerpodman 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

bash
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

來源：README.md，提交 f70f67d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分