Container Manager MCP

容器管理器-A2A|AG-UI|MCP

*版本：1.11.0*

概述

容器管理器提供了一个强大的通用接口来管理Docker和Podman容器、网络、卷、， 以及Docker Swarm服务，实现程序化和远程容器管理。

此软件包包含MCP服务器+A2A服务器开箱即用！

此存储库正在积极维护中-欢迎投稿！

特性

• 管理Docker和Podman容器、映像、卷和网络
• 支持Docker Swarm操作
• 支持Docker Compose和Podman Compose操作
• 用于远程API访问的FastMCP服务器
• 全面的日志记录和错误处理
• 用于额外容器运行时的可扩展架构
• 用于委托集装箱管理的多代理A2A系统

主控程序

MCP工具

• get_version：检索容器运行时的版本信息
• get_info：获取有关容器运行时的系统信息
• list_images：列出所有可用图像
• pull_image：从注册表中提取图像
• remove_image：删除图像
• list_containers：列出正在运行或所有的容器
• run_container：运行一个新容器
• stop_container：停止正在运行的容器
• remove_container：移除容器
• get_container_logs：从容器中检索日志
• exec_in_container：在容器中执行命令
• list_volumes：列出所有卷
• create_volume：创建新卷
• remove_volume：删除卷
• list_networks：列出所有网络
• create_network：创建新网络
• remove_network：删除网络
• compose_up：启动Compose文件中定义的服务
• compose_down：停止并删除Compose文件中定义的服务
• compose_ps：列出Compose项目的容器
• compose_logs：查看Compose项目或特定服务的日志
• init_swarm：初始化Docker Swarm
• leave_swarm：离开Docker Swarm
• list_nodes：列出Docker Swarm中的节点
• list_services：列出Docker Swarm中的服务
• create_service：在Docker Swarm中创建新服务
• remove_service：从Docker Swarm中删除服务

MCP-CLI

A2A代理

A2A-CLI

端点

• Web 用户界面: http://localhost:8000/ （如果启用）
• A2A: http://localhost:8000/a2a （发现： /a2a/.well-known/agent.json)
• AG-UI: http://localhost:8000/ag-ui （职位）

图形架构

此代理使用 pydantic-graph 智能路由和最佳上下文管理的编排。

---
title: Container Manager MCP Graph Agent
---
stateDiagram-v2
  [*] --> RouterNode: User Query
  RouterNode --> DomainNode: Classified Domain
  RouterNode --> [*]: Low confidence / Error
  DomainNode --> [*]: Domain Result

• 路由器节点：快速、轻便的LLM（例如。， nvidia/nemotron-3-super)它将用户的查询分类到一个专门的域中。
• 域节点：执行器节点。对于所选域，它动态设置环境变量，以暂时仅启用与该域相关的工具，从而创建高度集中的子代理（例如。， gpt-4o)以完成请求。这保留了LLM上下文并防止了工具幻觉。

用法

用作MCP服务器

MCP服务器可以在两种模式下运行： stdio （用于本地测试）或 http （用于网络访问）。要启动服务器，请使用以下命令：

在stdio模式下运行（默认）：

container-manager-mcp

在HTTP模式下运行：

container-manager-mcp --transport "http"  --host "0.0.0.0"  --port "8000"

将MCP服务器部署为服务

ServiceNow MCP服务器可以使用Docker部署，具有可配置的身份验证、中间件和Eunomia授权。

使用Docker运行

docker pull knucklessg1/container-manager:latest

docker run -d \
  --name container-manager-mcp \
  -p 8004:8004 \
  -e HOST=0.0.0.0 \
  -e PORT=8004 \
  -e TRANSPORT=streamable-http \
  -e AUTH_TYPE=none \
  -e EUNOMIA_TYPE=none \
  knucklessg1/container-manager:latest

运行A2A代理（Docker）：

docker run -d \
  --name container-manager-agent \
  -p 9000:9000 \
  -e PORT=9000 \
  -e PROVIDER=openai \
  -e MODEL_ID=nvidia/nemotron-3-super \
  -e BASE_URL=http://host.docker.internal:11434/v1 \
  -e MCP_URL=http://host.docker.internal:8004/mcp \
  knucklessg1/container-manager:latest \
  container-manager-agent

对于高级身份验证（例如JWT、OAuth代理、OIDC代理、远程OAuth）或Eunomia，添加相关的环境变量：

docker run -d \
  --name container-manager-mcp \
  -p 8004:8004 \
  -e HOST=0.0.0.0 \
  -e PORT=8004 \
  -e TRANSPORT=streamable-http \
  -e AUTH_TYPE=oidc-proxy \
  -e OIDC_CONFIG_URL=https://provider.com/.well-known/openid-configuration \
  -e OIDC_CLIENT_ID=your-client-id \
  -e OIDC_CLIENT_SECRET=your-client-secret \
  -e OIDC_BASE_URL=https://your-server.com \
  -e ALLOWED_CLIENT_REDIRECT_URIS=http://localhost:*,https://*.example.com/* \
  -e EUNOMIA_TYPE=embedded \
  -e EUNOMIA_POLICY_FILE=/app/mcp_policies.json \
  knucklessg1/container-manager:latest

使用Docker Compose

创建一个 docker-compose.yml 文件：

services:
  container-manager-mcp:
    image: knucklessg1/container-manager:latest
    environment:
      - HOST=0.0.0.0
      - PORT=8004
      - TRANSPORT=streamable-http
      - AUTH_TYPE=none
      - EUNOMIA_TYPE=none
    ports:
      - 8004:8004

对于具有身份验证和Eunomia的高级设置：

services:
  container-manager-mcp:
    image: knucklessg1/container-manager:latest
    environment:
      - HOST=0.0.0.0
      - PORT=8004
      - TRANSPORT=streamable-http
      - AUTH_TYPE=oidc-proxy
      - OIDC_CONFIG_URL=https://provider.com/.well-known/openid-configuration
      - OIDC_CLIENT_ID=your-client-id
      - OIDC_CLIENT_SECRET=your-client-secret
      - OIDC_BASE_URL=https://your-server.com
      - ALLOWED_CLIENT_REDIRECT_URIS=http://localhost:*,https://*.example.com/*
      - EUNOMIA_TYPE=embedded
      - EUNOMIA_POLICY_FILE=/app/mcp_policies.json
    ports:
      - 8004:8004
    volumes:
      - ./mcp_policies.json:/app/mcp_policies.json

运行服务：

docker-compose up -d

配置 mcp.json AI集成

{
  "mcpServers": {
    "container_manager": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "container-manager-mcp",
        "container-manager-mcp"
      ],
      "env": {
        "CONTAINER_MANAGER_SILENT": "False",                                  //Optional
        "CONTAINER_MANAGER_LOG_FILE": "~/Documents/container_manager_mcp.log" //Optional
        "CONTAINER_MANAGER_TYPE": "podman",                                   //Optional
        "CONTAINER_MANAGER_PODMAN_BASE_URL": "tcp://127.0.0.1:8080"           //Optional
      },
      "timeout": 200000
    }
  }
}

安装Python包

python -m pip install container-manager-mcp

或

uv pip install --upgrade container-manager-mcp

测试

container-manager-mcp --transport streamable-http --host 127.0.0.1 --port 8080

这将使用本地主机端口8080上的HTTP传输启动MCP服务器。

要以编程方式与MCP服务器交互，您可以使用FastMCP客户端或向公开的端点发出HTTP请求。使用curl拉取图像的示例：

curl -X POST http://127.0.0.1:8080/pull_image \
  -H "Content-Type: application/json" \
  -d '{"image": "nginx", "tag": "latest", "manager_type": "docker"}'

安装Python包：

python -m pip install container-manager-mcp

依赖项

• Python 3.7+
• fastmcp 用于MCP服务器功能
• docker Docker支持
• podman 为Podman提供支持
• pydantic 用于数据验证

安装依赖项：

python -m pip install fastmcp docker podman pydantic

确保Docker或Podman已安装并在您的系统上运行。

发展与贡献

欢迎投稿！贡献：

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/your-feature)
3. 提交您的更改(git commit -am 'Add your feature')
4. 推到分支(git push origin feature/your-feature)
5. 创建新的Pull请求

请确保您的代码遵循项目的编码标准，并包含适当的测试。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

存储库所有者

MCP配置示例

1.标准IO（stdio）部署

{
  "mcpServers": {
    "container-manager-mcp": {
      "command": "uv",
      "args": [
        "run",
        "container-manager-mcp"
      ],
      "env": {
        "AGENT_DESCRIPTION": "",
        "AGENT_SYSTEM_PROMPT": "",
        "COMPOSETOOL": "True",
        "CONTAINERTOOL": "True",
        "CONTAINER_MANAGER_LOG_FILE": "",
        "CONTAINER_MANAGER_PODMAN_BASE_URL": "",
        "CONTAINER_MANAGER_SILENT": "",
        "CONTAINER_MANAGER_TYPE": "",
        "DEFAULT_AGENT_NAME": "",
        "IMAGETOOL": "True",
        "INFOTOOL": "True",
        "LLM_API_KEY": "",
        "LLM_BASE_URL": "",
        "LOGTOOL": "True",
        "MCP_URL": "",
        "MISCTOOL": "True",
        "MODEL_ID": "",
        "NETWORKTOOL": "True",
        "SPECIALIST_TOOL": "True",
        "SWARMTOOL": "True",
        "SYSTEMTOOL": "True",
        "VOLUMETOOL": "True"
      }
    }
  }
}

2.流式HTTP（SSE）部署

{
  "mcpServers": {
    "container-manager-mcp": {
      "command": "uv",
      "args": [
        "run",
        "container-manager-mcp",
        "--transport",
        "http",
        "--host",
        "0.0.0.0",
        "--port",
        "8000"
      ],
      "env": {
        "AGENT_DESCRIPTION": "",
        "AGENT_SYSTEM_PROMPT": "",
        "COMPOSETOOL": "True",
        "CONTAINERTOOL": "True",
        "CONTAINER_MANAGER_LOG_FILE": "",
        "CONTAINER_MANAGER_PODMAN_BASE_URL": "",
        "CONTAINER_MANAGER_SILENT": "",
        "CONTAINER_MANAGER_TYPE": "",
        "DEFAULT_AGENT_NAME": "",
        "IMAGETOOL": "True",
        "INFOTOOL": "True",
        "LLM_API_KEY": "",
        "LLM_BASE_URL": "",
        "LOGTOOL": "True",
        "MCP_URL": "",
        "MISCTOOL": "True",
        "MODEL_ID": "",
        "NETWORKTOOL": "True",
        "SPECIALIST_TOOL": "True",
        "SWARMTOOL": "True",
        "SYSTEMTOOL": "True",
        "VOLUMETOOL": "True"
      }
    }
  }
}