What is Podman Mcp Server

Podman MCP Server is a Model Context Protocol (MCP) server designed for container runtimes such as Podman and Docker, enabling efficient communication and management of containerized applications.

Use cases

Use cases for Podman MCP Server include managing AI agents in applications, integrating with development tools for container orchestration, and providing real-time updates for containerized services through SSE.

How to use

To use Podman MCP Server, you can integrate it into your configuration files for Claude Desktop or Goose CLI. For Claude Desktop, add the MCP server to the claude_desktop_config.json file. For Goose CLI, include it in the config.yaml file. You can run it using npx or the latest release binary.

Key features

Key features of Podman MCP Server include support for Server-Sent Events (SSE), flexible configuration options through command line arguments, and compatibility with both Podman and Docker container runtimes.

Where to use

Podman MCP Server can be used in various fields where containerized applications are deployed, such as cloud computing, microservices architecture, and development environments that require efficient container management.

Podman MCP Server

✨ Features | 🚀 Getting Started | 🎥 Demos | ⚙️ Configuration | 🧑‍💻 Development

✨ Features

A powerful and flexible MCP server for container runtimes supporting Podman and Docker.

🚀 Getting Started

Claude Desktop

Using npx

If you have npm installed, this is the fastest way to get started with podman-mcp-server on Claude Desktop.

Open your claude_desktop_config.json and add the mcp server to the list of mcpServers:

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

VS Code / VS Code Insiders

Install the Podman MCP server extension in VS Code Insiders by pressing the following link:

Alternatively, you can install the extension manually by running the following command:

# For VS Code
code --add-mcp '{"name":"podman","command":"npx","args":["podman-mcp-server@latest"]}'
# For VS Code Insiders
code-insiders --add-mcp '{"name":"podman","command":"npx","args":["podman-mcp-server@latest"]}'

Goose CLI

Goose CLI is the easiest (and cheapest) way to get rolling with artificial intelligence (AI) agents.

Using npm

If you have npm installed, this is the fastest way to get started with podman-mcp-server.

Open your goose config.yaml and add the mcp server to the list of mcpServers:

extensions:
  podman:
    command: npx
    args:
      - -y
      - podman-mcp-server@latest

🎥 Demos

⚙️ Configuration

The Podman MCP server can be configured using command line (CLI) arguments.

You can run the CLI executable either by using npx or by downloading the latest release binary.

# Run the Podman MCP server using npx (in case you have npm installed)
npx podman-mcp-server@latest --help

# Run the Podman MCP server using the latest release binary
./podman-mcp-server --help

Configuration Options

🧑‍💻 Development

Running with mcp-inspector

Compile the project and run the Podman MCP server with mcp-inspector to inspect the MCP server.

# Compile the project
make build
# Run the Podman MCP server with mcp-inspector
npx @modelcontextprotocol/inspector@latest $(pwd)/podman-mcp-server