mcp-containerd

mcp-containerd

29
os_automation

MCP Containerd is an MCP server utilizing the RMCP library to manage Containerd's CRI interfaces. It provides comprehensive runtime and image services to facilitate container management using Rust.

MCP Containerd

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

Features

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

Prerequisites

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

Building

cargo build --release

Running

cargo run --release

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
AI: Listing containers...
Tool: list_containers
Result: {"containers":[...]}

> please give me a list of images
AI: Here are the images in your containerd:
Tool: list_images
Result: {"images":[...]}

Service Structure

The MCP server includes the following main components:

  • version service: Provides CRI version information
  • runtime service: Provides container and Pod runtime operations
  • image service: Provides container image operations

CRI Interfaces

Runtime Service

  • Create/Stop/Delete Pod Sandbox
  • Create/Start/Stop/Delete containers
  • Query Pod/container status
  • Execute commands in containers

Image Service

  • List images
  • Get image status
  • Pull images
  • Delete images
  • Get image filesystem information

Configuration

Currently using default configuration. Future versions will support customizing connection parameters through configuration files.

License

Apache-2.0