使用说明

项目简介

Podman MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为支持 Podman 和 Docker 的容器运行时提供强大的管理功能。它允许LLM客户端通过标准化的 MCP 协议，调用预定义工具来管理容器和镜像，例如查看容器信息、列出容器、获取容器日志、运行和停止容器以及拉取镜像。

主要功能点

容器管理工具: 提供一系列工具用于管理 Podman 和 Docker 容器，包括：
- 'container_inspect': 查看容器的详细信息。
- 'container_list': 列出所有容器。
- 'container_logs': 获取容器的日志。
- 'container_run': 运行一个新的容器。
- 'container_stop': 停止一个正在运行的容器。
- 'container_image_pull': 拉取容器镜像。
基于 MCP 协议: 遵循 MCP 协议标准，能够与任何兼容 MCP 协议的 LLM 客户端进行通信。
支持 Stdio 和 SSE: 提供 Stdio 和 SSE 两种传输协议，方便不同场景下的部署和使用。
易于安装和配置: 可以通过 npm 或 npx 快速安装和启动，并提供简单的配置方式。

安装步骤

前提条件: 确保已安装 Node.js 和 npm (或 npx)。
安装 Podman MCP Server: 无需显式安装，可以直接通过 npx 运行。

服务器配置

对于 MCP 客户端，您需要配置 MCP 服务器的启动命令和参数。以下是使用 npx 启动 Podman MCP Server 的配置示例 (JSON 格式)：

{
  "mcpServers": {
    "podman": {
      "command": "npx",
      "args": [
        "-y",
        "podman-mcp-server@latest"
      ]
    }
  }
}

配置参数说明:

'server name': 'podman' (用户自定义的服务器名称，用于在客户端中引用)
'command': 'npx' (启动命令，这里使用 npx 运行 npm 包)
'args': 启动参数，包括：
- '-y': (npx 参数) 自动确认安装 npm 包。
- 'podman-mcp-server@latest': 指定要运行的 npm 包及其版本（latest 表示最新版本）。

注意: 以上配置示例适用于 Claude Desktop 或 Goose CLI 等 MCP 客户端。具体的配置方法请参考您使用的 MCP 客户端的文档。

基本使用方法

启动 MCP 服务器: 根据 MCP 客户端的要求配置并启动 Podman MCP Server。
在 LLM 客户端中调用工具: 在您的 LLM 应用中，可以使用 MCP 客户端库连接到 Podman MCP Server。
使用容器管理工具: 通过客户端向服务器发送 'CallToolRequest' 请求，调用例如 'container_list', 'container_inspect' 等工具，并获取返回的容器信息或操作结果。具体可用的工具名称和参数请参考 "主要功能点" 描述。

例如，在支持 MCP 协议的 LLM 应用中，您可以使用配置好的 "podman" 服务器，通过工具名称 'container_list' 来获取当前运行的所有容器列表。

关键词