manusa/podman-mcp-server

View on GitHub ↗

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

81 ★19 forksGoUpdated 18d ago

What you need to know

MCP server for container runtimes supporting Podman and Docker — inspect, run, stop, remove containers; build, pull, push, list images; list networks and volumes — via stdio, HTTP (Streamable HTTP + SSE), or legacy SSE.

Install

npx -y podman-mcp-server@latest
or latest release binary; npm and PyPI packages available

Usage

  • •add to claude_desktop_config.json / goose config.yaml as an MCP server, then ask to run/list containers, build/pull images, etc.

Key features

  • ✓container tools: list, inspect, logs, run (env/ports), stop, remove
  • ✓image tools: build, list, pull, push, remove
  • ✓network_list and volume_list
  • ✓--port enables HTTP mode with Streamable HTTP at /mcp and SSE at /sse
  • ✓--podman-impl api (REST via Unix socket, preferred) or cli (podman/docker binary fallback) with auto-detection
  • ✓text or json output format

Best for

Managing Podman/Docker containers and images from an AI assistant.

Caveats

  • ⚠requires a working Podman (or Docker) installation
  • ⚠--sse-port / --sse-base-url are deprecated
  • ⚠lighter toolset than full container orchestrators
Platforms: macOS · Linux · WindowsClients: Claude Desktop · VS Code · Goose

Reviewed 2026-08-11

Topics

container-runtimecontainerscontextdockermcpmodelmodel-context-protocolpodmanprotocol
Stars
81★
Forks
19
Language
Go
License
Apache-2.0
Created
2025-02-28
Last push
2026-08-17