Knuckles-Team/container-manager-mcp

Available MCP Tools

• get_version: Retrieve version information of the container runtime
• get_info: Get system information about the container runtime
• list_images: List all available images
• pull_image: Pull an image from a registry
• remove_image: Remove an image
• list_containers: List running or all containers
• run_container: Run a new container
• stop_container: Stop a running container
• remove_container: Remove a container
• get_container_logs: Retrieve logs from a container
• exec_in_container: Execute a command in a container
• list_volumes: List all volumes
• create_volume: Create a new volume
• remove_volume: Remove a volume
• list_networks: List all networks
• create_network: Create a new network
• remove_network: Remove a network
• compose_up: Start services defined in a Compose file
• compose_down: Stop and remove services defined in a Compose file
• compose_ps: List containers for a Compose project
• compose_logs: View logs for a Compose project or specific service
• init_swarm: Initialize a Docker Swarm
• leave_swarm: Leave a Docker Swarm
• list_nodes: List nodes in a Docker Swarm
• list_services: List services in a Docker Swarm
• create_service: Create a new service in a Docker Swarm
• remove_service: Remove a service from a Docker Swarm

Use with AI

Configure mcp.json

{
  "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
    }
  }
}

Deploy MCP Server as a container

docker pull knucklessg1/container-manager:latest

Modify the compose.yml

services:
  container-manager-mcp:
    image: knucklessg1/container-manager:latest
    environment:
      - HOST=0.0.0.0
      - PORT=8015
    ports:
      - 8015:8015

Install Python Package

python -m pip install container-manager-mcp

or

uv pip install --upgrade container-manager-mcp

Test Server

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

This starts the MCP server using HTTP transport on localhost port 8080.

To interact with the MCP server programmatically, you can use a FastMCP client or make HTTP requests to the exposed endpoints. Example using curl to pull an image:

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

Install the Python package:

python -m pip install container-manager-mcp

Dependencies

• Python 3.7+
• fastmcp for MCP server functionality
• docker for Docker support
• podman for Podman support
• pydantic for data validation

Install dependencies:

python -m pip install fastmcp docker podman pydantic

Ensure Docker or Podman is installed and running on your system.

Development and Contribution

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -am 'Add your feature')
4. Push to the branch (git push origin feature/your-feature)
5. Create a new Pull Request

Please ensure your code follows the project's coding standards and includes appropriate tests.

License

This project is licensed under the MIT License - see the LICENSE file for details.