返回 MCP 目录
public公开dns本地运行

podman-mcp-server

一个支持Podman和Docker的容器运行时MCP服务器

article

README

🚀 Podman MCP 服务器

Podman MCP 服务器是一个强大且灵活的工具,支持 Podman 和 Docker 容器运行时,能为容器管理提供高效的解决方案。

✨ 主要特性 | 🚀 快速开始 | 🎥 演示 | ⚙️ 配置 | 🧑‍💻 开发

✨ 主要特性

一个强大且灵活的 MCP 服务器,支持 Podman 和 Docker 容器运行时。

🚀 快速开始

使用 Claude Desktop

使用 npx

若你已安装 npm,这是在 Claude Desktop 上快速使用 podman-mcp-server 的最佳方式。

打开 claude_desktop_config.json 文件,将 MCP 服务器添加到 mcpServers 列表:

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

使用 VS Code / VS Code Insiders

可通过以下链接在 VS Code 或 VS Code Insiders 中安装 Podman MCP 服务器扩展:

也可通过以下命令手动安装:

npx @modelcontextprotocol/mcp-serve@latest podman

使用 Goose CLI

在终端运行以下命令启动 Podman MCP 服务器:

goose mcp serve --name podman

🎥 演示

我们提供了一些演示视频,展示如何使用 Podman MCP 服务器:

⚙️ 配置

常用选项

以下是 podman-mcp-server 命令的常用配置选项: | 选项 | 详情 | 示例值 | | ---- | ---- | ---- | | --port | 指定服务器监听的端口 | 5000 | | --mode | 设置运行模式(支持 ssehttp) | sae | | --cert | 使用 TLS 证书文件路径 | /path/to/cert.pem | | --key | 使用 TLS 密钥文件路径 | /path/to/key.pem |

示例命令

  1. 在 SSE 模式下启动服务器:
podman-mcp-server --port 5000 --mode sse
  1. 在 HTTP 模式下启动服务器,并指定证书和密钥:
podman-mcp-server --port 5001 --mode http --cert /path/to/cert.pem --key /path/to/key.pem

🧑‍💻 开发

使用 mcp-inspector 进行开发

使用 mcp-inspector 工具调试和验证 MCP 服务器实现。

# 安装依赖项
npm install @modelcontextprotocol/inspector

# 启动 Podman MCP 服务器并附加 inspectors
npx @modelcontextprotocol/inspector@latest podman-mcp-server

贡献代码

若你想为项目贡献代码,请按以下步骤操作:

  1. 克隆仓库:
git clone https://github.com/manusa/podman-mcp-server.git
cd podman-mcp-server
  1. 创建功能分支:
git checkout -b feature/your-feature-name
  1. 提交更改并创建 Pull Request。

问题反馈

若你遇到问题,请在 GitHub Issues 提交,我们会尽快处理。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端