English Français العربية

MCP Podman

السجل الرسمي أخرى

MCP server for Podman container management via the Podman REST API

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package mcp-podman-crunchtools
Claude Code 
claude mcp add mcp-podman -- uvx mcp-podman-crunchtools==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-podman": {
            "command": "uvx",
            "args": [
                "mcp-podman-crunchtools==0.1.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. mcp-podman-crunchtools
  2. Installation
  3. Configuration
  4. Claude Code Integration
  5. Tools (30)
  6. License

mcp-podman-crunchtools

MCP server for Podman container management via the Podman REST API. Manages containers, images, pods, networks, volumes, and system info. Supports both rootful and rootless Podman.

Installation

# uvx (zero-install)
uvx mcp-podman-crunchtools

# pip
pip install mcp-podman-crunchtools

# Container
podman run -v /run/podman/podman.sock:/run/podman/podman.sock:z \
  --security-opt label=type:container_runtime_t \
  quay.io/crunchtools/mcp-podman

Configuration

VariableRequiredDefaultDescription
PODMAN_SOCKETNoAuto-detectUnix socket path
PODMAN_SOCKET_FILENo—File containing socket path
PODMAN_TIMEOUTNo30Request timeout in seconds

Socket auto-detection order:

  1. $XDG_RUNTIME_DIR/podman/podman.sock (rootless)
  2. /run/user/$UID/podman/podman.sock (rootless fallback)
  3. /run/podman/podman.sock (rootful)

Claude Code Integration

claude mcp add mcp-podman-crunchtools \
  --env PODMAN_SOCKET=/run/podman/podman.sock \
  -- uvx mcp-podman-crunchtools

Tools (30)

Containers (12)
ToolDescription
container_listList containers
container_inspectGet container details; environment values are redacted, names kept
container_startStart a container
container_stopStop a container
container_restartRestart a container
container_killSend signal to container
container_rmRemove a container
container_logsGet container logs
container_topList processes
container_statsResource usage
container_createCreate a container
container_pruneRemove stopped containers
Images (5)
ToolDescription
image_listList images
image_inspectGet image details
image_pullPull from registry
image_rmRemove an image
image_pruneRemove unused images, with the options of podman image prune (all, external, build_cache, filters)
Pods (7)
ToolDescription
pod_listList pods
pod_inspectGet pod details
pod_startStart a pod
pod_stopStop a pod
pod_restartRestart a pod
pod_rmRemove a pod
pod_createCreate a pod
Networks (2)
ToolDescription
network_listList networks
network_inspectGet network details
Volumes (2)
ToolDescription
volume_listList volumes
volume_inspectGet volume details
System (2)
ToolDescription
system_infoPodman system info
system_dfDisk usage

License

AGPL-3.0-or-later

الأسئلة الشائعة

ما هو MCP Podman؟

MCP server for Podman container management via the Podman REST API

كيف أثبّت MCP Podman؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-podman -- uvx mcp-podman-crunchtools==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج MCP Podman إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل MCP Podman مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص AGPL-3.0.

من يصون MCP Podman؟

ينشره crunchtools. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.