MCP Podman

mcp-podman-crunchtools

Podman REST API を介して Podman コンテナを管理する MCP サーバーです。コンテナ、イメージ、ポッド、ネットワーク、ボリューム、システム情報を管理します。rootful と rootless の両方の Podman に対応しています。

インストール

# 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

設定

変数	必須	デフォルト	説明
PODMAN_SOCKET	いいえ	自動検出	Unix ソケットのパス
PODMAN_SOCKET_FILE	いいえ	—	ソケットパスを含むファイル
PODMAN_TIMEOUT	いいえ	30	リクエストのタイムアウト（秒）

ソケットは次の順序で自動検出されます。

1. $XDG_RUNTIME_DIR/podman/podman.sock（rootless）
2. /run/user/$UID/podman/podman.sock（rootless のフォールバック）
3. /run/podman/podman.sock（rootful）

Claude Code との連携

claude mcp add mcp-podman-crunchtools \
  --env PODMAN_SOCKET=/run/podman/podman.sock \
  -- uvx mcp-podman-crunchtools

ツール（30）

コンテナ（12）

ツール	説明
container_list	コンテナを一覧表示
container_inspect	コンテナの詳細を取得します。環境変数の値は秘匿され、名前は保持されます
container_start	コンテナを起動
container_stop	コンテナを停止
container_restart	コンテナを再起動
container_kill	コンテナにシグナルを送信
container_rm	コンテナを削除
container_logs	コンテナのログを取得
container_top	プロセスを一覧表示
container_stats	リソース使用状況
container_create	コンテナを作成
container_prune	停止中のコンテナを削除

イメージ（5）

ツール	説明
image_list	イメージを一覧表示
image_inspect	イメージの詳細を取得
image_pull	レジストリからプル
image_rm	イメージを削除
image_prune	podman image prune のオプション（all、external、build_cache、filters）を指定して未使用のイメージを削除

ポッド（7）

ツール	説明
pod_list	ポッドを一覧表示
pod_inspect	ポッドの詳細を取得
pod_start	ポッドを起動
pod_stop	ポッドを停止
pod_restart	ポッドを再起動
pod_rm	ポッドを削除
pod_create	ポッドを作成

ネットワーク（2）

ツール	説明
network_list	ネットワークを一覧表示
network_inspect	ネットワークの詳細を取得

ボリューム（2）

ツール	説明
volume_list	ボリュームを一覧表示
volume_inspect	ボリュームの詳細を取得

システム（2）

ツール	説明
system_info	Podman システム情報
system_df	ディスク使用量

ライセンス

AGPL-3.0-or-later