Podman MCP Server

by manusa

76 stars
801 downloads
Not rated
GitHub

About

Model Context Protocol (MCP) server for container runtimes (Podman and Docker)

Details

Author
manusa
GitHub stars
76
Downloads
801
Categories
Cloud Service

- Supports both Podman and Docker container runtimes
- Provides tools for containers, images, networks, and volumes
- Multiple transport modes: STDIO, HTTP (Streamable HTTP/SSE), and SSE-only
- Auto-detects best backend: REST API via socket or CLI wrapper
- Configurable output format (text or JSON)
- Easy integration with Claude Desktop, VS Code, and Goose CLI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Podman MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npm (npx -y podman-mcp-server@latest) or download the latest release binary. Configure in Claude Desktop, VS Code, or Goose CLI by adding it to the MCP servers configuration. Optionally pass CLI arguments like --port for HTTP mode or --podman-impl to force a specific backend implementation.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Podman MCP Server

GitHub License
npm
PyPI - Version
GitHub release (latest SemVer)
Build

✨ Features | 🚀 Getting Started | 📚 Documentation | 🎥 Demos | ⚙️ Configuration | 🛠️ Tools | 🧑‍💻 Development

✨ Features <a id="features"></a>

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

🚀 Getting Started <a id="getting-started"></a>

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:
``` json
{
"mcpServers": {
"podman": {
"command": "npx",
"args": [
"-y",
"podman-mcp-server@latest"
]
}
}
}


VS Code / VS Code Insiders

Install the Podman MCP server by clicking one of the following links:

Install in VS Code
Install in VS Code Insiders

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

shell

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.