Ceph MCP Server

A Model Context Protocol (MCP) server for Ceph, enabling AI assistants and MCP clients to interact with Ceph storage clusters through a standardized interface.

Overview

This MCP server provides programmatic access to Ceph resources, allowing AI assistants like Claude to manage and query Ceph storage infrastructure using natural language. Built with the mark3labs/mcp-go SDK.

Features

Current Ceph service support:

• Cluster Health - Monitor cluster status
  • Get cluster health
• Pool Management - Storage pool operations
  • List pools
  • Get pool statistics
• RBD (RADOS Block Device) - Block storage management
  • List RBD images
  • Get image details
• OSD Management - Object Storage Daemon operations
  • Get OSD tree (hierarchy and status)
  • Get OSD information
  • Get placement group (PG) summary

Prerequisites

System Libraries

The Ceph client requires native Ceph libraries. Install them before building:

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y librados-dev librbd-dev

Other Requirements

• Go 1.24.2+ - Required to build and run the server
• Ceph Cluster - Access to a Ceph cluster with credentials
• MCP Client - Such as MCP Inspector for testing

Quick Start

1. Get Your Ceph Credentials

On your Ceph cluster, get the client admin key:

sudo ceph auth get client.admin

Output will look like:

[client.admin]
    key = AQApH1tpul4oBxAAUhmSGzHOlG0bjB8qbaqI0A==

2. Set Ceph Credentials

Export your Ceph authentication credentials as environment variables:

export CEPHMCP_CEPH_MONITORS="localhost:6789"
export CEPHMCP_CEPH_CLIENT_ID="admin"
# Repalce with your key
export CEPHMCP_CEPH_KEY="AQApH1tpul4oBxAAUhmSGzHOlG0bjB8qbaqI0A=="
export CEPHMCP_CEPH_DEFAULT_POOL="rbd"

3. Build and Start the Server

# Build
go build -o bin/mcp-server ./cmd/mcp-server

# Run with stdio transport (default)
./bin/mcp-server serve

# Run with HTTP transport
./bin/mcp-server serve --transport http --port 8080

Available Tools

Cluster Health

Tool	Description	Read-Only
ceph_cluster_health	Get cluster health status	Yes

Pool Management

Tool	Description	Read-Only
ceph_list_pools	List all storage pools	Yes
ceph_get_pool_stats	Get statistics for a specific pool	Yes

RBD (RADOS Block Device)

Tool	Description	Read-Only
ceph_list_rbd_images	List RBD images in a pool	Yes
ceph_get_rbd_image_info	Get detailed information about an RBD image	Yes

OSD (Object Storage Daemon)

Tool	Description	Read-Only
ceph_get_osd_tree	Get OSD tree showing CRUSH hierarchy and status	Yes
ceph_get_osd_info	Get detailed information about a specific OSD	Yes
ceph_get_pg_summary	Get placement group status summary	Yes

Configuration

Configuration File

Create ceph-mcp-server.yaml in your home directory or project root:

server:
  name: "ceph-mcp-server"
  version: "0.1.0"

logging:
  level: "info"      # debug, info, warn, error
  format: "json"     # json, text

ceph:
  monitors:
    - "10.149.36.253:6789"
    - "10.149.36.254:6789"
  client_id: "admin"
  key: "AQApH1tpul4oBxAAUhmSGzHOlG0bjB8qbaqI0A=="
  default_pool: "rbd"

mcp:
  transport:
    type: "stdio"    # stdio or http
    host: "localhost"
    port: 8080
    timeout: "30s"

shutdown:
  timeout: "30s"

Environment Variables

All configuration can be set via environment variables using the CEPHMCP_ prefix:

Ceph settings:

• CEPHMCP_CEPH_MONITORS - Comma-separated monitor addresses (e.g., "mon1:6789,mon2:6789")
• `CEPHMCP_C

... View full README on GitHub