Containerd

by jokemanfire

50 stars

Not rated

GitHub

About

Enables container management through natural language commands by bridging Containerd's Container Runtime Interface for listing, creating, and removing containers and pods without complex CLI syntax.

Details

Author: jokemanfire
Repository: jokemanfire/mcp-containerd
GitHub stars: 50
Categories: Productivity, Developer Tools, Design, AI, Media, Frontend
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Containerd

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

mcp-containerd -t http  #use streamhttp
mcp-containerd --help #list the help info

By default, the service will connect to the unix:///run/containerd/containerd.sock endpoint.

`list_containers`

List all containers managed by the MCP Containerd service.

`list_images`

List all images available in the containerd.

`create_pod_sandbox`

Create a new Pod Sandbox.

`stop_pod_sandbox`

Stop a running Pod Sandbox.

`delete_pod_sandbox`

Delete a Pod Sandbox.

`create_container`

Create a new container.

`start_container`

Start a stopped container.

`stop_container`

Stop a running container.

`delete_container`

Delete a container.

`query_pod_status`

Query the status of a specific Pod.

`query_container_status`

Query the status of a specific container.

`execute_command_in_container`

Execute a command inside a running container.

`get_image_status`

Retrieve the status of a specific image.

`pull_image`

Pull an image into the containerd.

`delete_image`

Delete a specified image from the containerd.

`get_image_filesystem_info`

Get filesystem information of a specific image.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "containerd": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

MCP Containerd

This is an MCP server implemented using the RMCP (Rust Model Context Protocol) library for operating Containerd.

Features

- Implements an MCP server using the RMCP library
- Supports all Containerd CRI interface operations
- Provides Runtime Service interfaces
- Provides Image Service interfaces
- Supports ctr interface

Prerequisites

- Rust development environment
- Containerd installed and running
- Protobuf compilation tools

Building

cargo build --release

Running

mcp-containerd -t http  #use streamhttp
mcp-containerd --help #list the help info

By default, the service will connect to the unix:///run/containerd/containerd.sock endpoint.

Using with simple-chat-client

The simple-chat-client allows you to interact with the MCP Containerd service:
simple-chat-client has moved to simple-chat-client

Example interaction:

```
> please give me a list of containers

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list_containers

list_images

create_pod_sandbox

stop_pod_sandbox

delete_pod_sandbox

create_container

start_container

stop_container

delete_container

query_pod_status

query_container_status

execute_command_in_container

get_image_status

pull_image

delete_image

get_image_filesystem_info

Claude Desktop / Cursor

Linux

Macos

Windows

MCP Containerd

Features

Prerequisites

Building

Running

Using with simple-chat-client

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`list_containers`

`list_images`

`create_pod_sandbox`

`stop_pod_sandbox`

`delete_pod_sandbox`

`create_container`

`start_container`

`stop_container`

`delete_container`

`query_pod_status`

`query_container_status`

`execute_command_in_container`

`get_image_status`

`pull_image`

`delete_image`

`get_image_filesystem_info`