MCP Podman

Name: MCP Podman
Author: crunchtools

本地服务

github.com/crunchtools云与基础设施03 天前更新

代码仓库

关于 MCP Podman

通过 Podman REST API 管理 Podman 的 MCP 服务，面向使用 rootful 或 rootless Podman 环境的用户。它涵盖容器、镜像、Pod、网络、卷和系统信息。

主要功能

01列出、检查和控制容器
02查看日志、进程和资源用量
03管理镜像和镜像清理
04创建和控制 Pod
05检查网络和卷
06查看 Podman 系统及磁盘用量

适用场景

01检查容器状态和日志
02启动、停止或重启容器
03查看镜像和 Pod 清单
04检查 Podman 资源和磁盘用量

MCP 相关

通过 Podman REST API 向 MCP 客户端提供容器、镜像、Pod、网络、卷和系统管理工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "crunchtools-podman": {
      "command": "uvx",
      "args": [
        "mcp-podman-crunchtools"
      ]
    }
  }
}

启动命令uvx mcp-podman-crunchtools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimcp-podman-crunchtools0.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-podman-crunchtools

用于通过 Podman REST API 管理 Podman 容器的 MCP 服务。可管理容器、镜像、Pod、网络、卷和系统信息。支持 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	请求超时时间，单位为秒

套接字自动检测顺序：

$XDG_RUNTIME_DIR/podman/podman.sock（rootless）
/run/user/$UID/podman/podman.sock（rootless 回退路径）
/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`）

Pod（7）

工具	说明
`pod_list`	列出 Pod
`pod_inspect`	获取 Pod 详情
`pod_start`	启动 Pod
`pod_stop`	停止 Pod
`pod_restart`	重启 Pod
`pod_rm`	移除 Pod
`pod_create`	创建 Pod

网络（2）

工具	说明
`network_list`	列出网络
`network_inspect`	获取网络详情

卷（2）

工具	说明
`volume_list`	列出卷
`volume_inspect`	获取卷详情

系统（2）

工具	说明
`system_info`	Podman 系统信息
`system_df`	磁盘使用情况

许可证

AGPL-3.0-or-later

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。