Podman
FreeNot checkedEnables management of Podman containers, pods, images, and compose stacks via natural language, with support for container stats, logs, exec, health analysis, a
About
Enables management of Podman containers, pods, images, and compose stacks via natural language, with support for container stats, logs, exec, health analysis, and a web dashboard.
README
A daemon-less FastMCP 3.5 control plane for Podman on Windows and WSL2 — containers, pods, compose stacks, system analytics, and a glass React web dashboard.
❓ What is Podman?
Podman (Pod Manager) is a lightweight, open-source container engine designed as a modern alternative to Docker.
While Docker relies on a monolithic background service (the Docker Daemon, dockerd) which can occasionally lock up or consume high idle resources on Windows, Podman operates on a daemon-less and rootless-first architecture:
- Zero Idle Overhead: Since there is no background daemon running 24/7, Podman consumes virtually no memory or CPU when your containers are stopped.
- Fork-Exec Process Model: Every container runs as a direct child process of your shell session, avoiding single-point-of-failure engine crashes.
- Native Kubernetes Pods: Podman allows you to group multiple containers into a single shared namespace (a Pod), making local development match Kubernetes production environments.
- Docker-CLI Compatible: Podman matches the Docker CLI commands. You can simply alias
dockertopodmanand keep using your existing scripts.
Install
| Method | Command |
|---|---|
| Claude Desktop | just mcpb-pack → drag .mcpb onto Claude (or grab podman-mcp.mcpb + install.ps1 from the latest release) |
| Windows (NSIS) | just build-native → run *-setup.exe |
| Dev (any OS) | uv sync && .\start.ps1 → localhost:11112 |
Ports
| Port | Service |
|---|---|
| 11112 | Frontend (Vite React SPA) |
| 11113 | Backend (FastAPI + MCP HTTP /mcp) |
Quick Start
git clone https://github.com/sandraschi/podman-mcp
cd podman-mcp
uv sync
.\start.ps1
Opens dashboard on http://127.0.0.1:11112. API bridge on 11113.
What You Can Do
- "List all running containers and show resource usage."
- "Deploy my compose stack and verify every service is healthy."
- "Compare nginx:1.25 and nginx:1.26 — what changed?"
- "Analyze container my-app — why is it restarting?"
- "Back up my database volume before the upgrade."
Feature Overview
| Area | Highlights |
|---|---|
| Containers | CRUD, logs, stats, exec, inspect, health analysis |
| Images | List, pull, build, tag, push, prune, search, compare |
| Compose | Projects, up/down, logs, config, YAML file analysis |
| Backup/Restore | save/load image, backup/restore volume, export compose |
| Podman Machine | Status, hang detection, triple-kill recovery, restart |
| AI Chat | SSE streaming, tool execution cards, LLM provider discovery |
| Agentic | Deploy, cleanup, diagnose, rollback workflows |
| Prefab Cards | Containers, images, daemon status, system info |
Documentation
| Doc | Contents |
|---|---|
| docs/TOOLS.md | Full MCP tool reference |
| docs/COMPOSE.md | Compose management & file analysis |
| docs/BACKUP.md | Podman backup & restore guide |
| docs/CHAT.md | AI chat & agentic workflows |
| docs/ARCHITECTURE.md | Stack, transport, REST API |
| docs/CONFIGURATION.md | Environment variables |
| docs/DEVELOPMENT.md | Build, just recipes, testing |
| docs/TROUBLESHOOTING.md | Common issues |
Requirements
Python 3.12+, Podman Engine 20.10+, Node.js 20+ (dev). Rust 1.70+ (Tauri build only).
License
MIT
Installing Podman
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/podman-mcpFAQ
Is Podman MCP free?
Yes, Podman MCP is free — one-click install via Unyly at no cost.
Does Podman need an API key?
No, Podman runs without API keys or environment variables.
Is Podman hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Podman in Claude Desktop, Claude Code or Cursor?
Open Podman on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
by GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiCompare Podman with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
