Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Podman

FreeNot checked

Enables management of Podman containers, pods, images, and compose stacks via natural language, with support for container stats, logs, exec, health analysis, a

GitHubEmbed

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

Just Python FastMCP Podman MIT

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 docker to podman and 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

from github.com/sandraschi/podman-mcp

Installing Podman

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/sandraschi/podman-mcp

FAQ

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

Compare Podman with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs