Podman MCP Server

✨ Возможности | 🚀 Начало работы | 📚 Документация | 🎥 Демонстрации | ⚙️ Конфигурация | 🛠️ Инструменты | 🧑‍💻 Разработка

✨ Возможности

Мощный и гибкий MCP-сервер для сред выполнения контейнеров с поддержкой Podman и Docker.

🚀 Начало работы

Claude Desktop

Использование npx

Если у вас установлен npm, это самый быстрый способ начать работу с podman-mcp-server в Claude Desktop.

Откройте файл claude_desktop_config.json и добавьте mcp-сервер в список mcpServers:

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

VS Code / VS Code Insiders

Установите Podman MCP-сервер, нажав на одну из следующих ссылок:

В качестве альтернативы вы можете установить расширение вручную, выполнив следующую команду:

# For VS Code
code --add-mcp '{"name":"podman","command":"npx","args":["-y","podman-mcp-server@latest"]}'
# For VS Code Insiders
code-insiders --add-mcp '{"name":"podman","command":"npx","args":["-y","podman-mcp-server@latest"]}'

Goose CLI

Goose CLI — это самый простой (и дешёвый) способ начать работать с агентами искусственного интеллекта (ИИ).

Использование npm

Если у вас установлен npm, это самый быстрый способ начать работу с podman-mcp-server.

Откройте файл config.yaml в Goose и добавьте mcp-сервер в список mcpServers:

extensions:
  podman:
    command: npx
    args:
      - -y
      - podman-mcp-server@latest

📚 Документация

Подробные руководства по настройке, справочник по конфигурации и спецификации функций см. в Документации.

🎥 Демонстрации

⚙️ Конфигурация

Podman MCP-сервер можно настроить с помощью аргументов командной строки (CLI).

Вы можете запустить исполняемый файл CLI с помощью npx или загрузив последний релизный бинарный файл.

# Run the Podman MCP server using npx (in case you have npm installed)
npx podman-mcp-server@latest --help

# Run the Podman MCP server using the latest release binary
./podman-mcp-server --help

Параметры конфигурации

Транспортные режимы

Сервер поддерживает несколько транспортных режимов:

1. Режим STDIO (по умолчанию) — связь через стандартный ввод/вывод
2. HTTP-режим (--port) — современный HTTP-транспорт с конечными точками Streamable HTTP и SSE
3. Режим только SSE (--sse-port) — устаревший транспорт Server-Sent Events (устарел)

# Start HTTP server on port 8080 (Streamable HTTP at /mcp and SSE at /sse)
podman-mcp-server --port 8080

# Legacy SSE-only server on port 8080 (deprecated, use --port instead)
podman-mcp-server --sse-port 8080

Реализации Podman

Сервер поддерживает несколько серверных реализаций Podman:

По умолчанию сервер автоматически определяет лучшую доступную реализацию. Реализация api предпочтительна, когда доступен сокет Podman, в противном случае используется реализация cli как запасной вариант. Используйте флаг --podman-impl, чтобы принудительно задать конкретную реализацию:

# Force CLI implementation
podman-mcp-server --podman-impl=cli

# Force API implementation (requires Podman socket)
podman-mcp-server --podman-impl=api

Реализация api взаимодействует напрямую с Podman REST API через Unix-сокет, тогда как реализация cli выполняет вызовы к бинарным файлам podman или docker.

🛠️ Инструменты

Контейнер

• container_inspect - Отображает низкоуровневую информацию и конфигурацию контейнера Docker или Podman с указанным ID или именем контейнера
• name (string) (обязательно) - ID или имя контейнера Docker или Podman для отображения информации

• container_list - Выводит информацию о запущенных контейнерах Docker или Podman

• container_logs - Отображает журналы контейнера Docker или Podman с указанным ID или именем контейнера
• name (string) (обязательно) - ID или имя контейнера Docker или Podman для отображения журналов

• container_remove - Удаляет контейнер Docker или Podman с указанным ID или именем контейнера (rm)
• name (string) (обязательно) - ID или имя контейнера Docker или Podman для удаления

• container_run - Запускает контейнер Docker или Podman с указанным именем образа
• environment (array) - Переменные окружения для установки в контейнере. Формат: <ключ>=<значение>. Пример: FOO=bar. (Необязательно, добавляйте только для установки переменных окружения)
• imageName (string) (обязательно) - Имя образа контейнера Docker или Podman для запуска
• ports (array) - Сопоставления портов для публикации на хосте. Формат: <хостПорт>:<контейнерПорт>. Пример: 8080:80. (Необязательно, добавляйте только для публикации портов)

• container_stop - Останавливает запущенный контейнер Docker или Podman с указанным ID или именем контейнера
• name (string) (обязательно) - ID или имя контейнера Docker или Podman для остановки

Образ

• image_build - Собирает образ Docker или Podman из Dockerfile, Podmanfile или Containerfile
• containerFile (string) (обязательно) - Абсолютный путь к Dockerfile, Podmanfile или Containerfile для сборки образа
• imageName (string) - Указывает имя, которое присваивается результирующему образу, если процесс сборки завершится успешно (--tag, -t)

• image_list - Выводит список образов Docker или Podman на локальной машине

• image_pull - Копирует (загружает) образ контейнера Docker или Podman из реестра в хранилище локальной машины
• imageName (string) (обязательно) - Имя образа контейнера Docker или Podman для загрузки

• image_push - Отправляет образ контейнера Docker или Podman, список манифестов или индекс образов из хранилища локальной машины в реестр
• imageName (string) (обязательно) - Имя образа контейнера Docker или Podman для отправки

• image_remove - Удаляет образ Docker или Podman из хранилища локальной машины
• imageName (string) (обязательно) - Имя образа контейнера Docker или Podman для удаления

Сеть

• network_list - Выводит список всех доступных сетей Docker или Podman

Том

• volume_list - Выводит список всех доступных томов Docker или Podman

🧑‍💻 Разработка

Запуск с mcp-inspector

Скомпилируйте проект и запустите Podman MCP сервер с mcp-inspector для проверки MCP-сервера.

# Compile the project
make build
# Run the Podman MCP server with mcp-inspector
npx @modelcontextprotocol/inspector@latest $(pwd)/podman-mcp-server

mcp-name: io.github.manusa/podman-mcp-server