Ceph MCP Server

@rajmohanram

Repository

Basic information

About Ceph MCP Server

Ceph MCP Server

#ceph#mcp #server #ai-assistant #storage-management

Ceph MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ceph-mcp-server": {
      "command": "uv",
      "args": [
        "init",
        "--python",
        "3.11"
      ]
    }
  }
}

Ceph MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Ceph MCP Server?

A Model Context Protocol (MCP) server that enables AI assistants to interact with Ceph storage clusters through natural language. It bridges AI tools and Ceph infrastructure, making storage management more accessible and intuitive.

How to use Ceph MCP Server?

Clone the repository, set up a UV project with Python 3.11, add dependencies (mcp httpx pydantic python-dotenv structlog asyncio-mqtt), configure a .env file with Ceph Manager credentials, then start the server with uv run python -m ceph_mcp.server. The server provides four MCP tools for health monitoring, host status, and detailed analysis.

Key features of Ceph MCP Server

Health Monitoring – comprehensive cluster health status and diagnostics
Host Management – monitor and manage cluster hosts and services
Detailed Analysis – access health checks for troubleshooting
Secure Communication – authenticated access to Ceph Manager API
Structured Responses – AI-friendly output formatting
Async Architecture – non-blocking operations for better performance

Use cases of Ceph MCP Server

Check overall cluster health and receive clear status summaries
Identify which hosts are online and what services are running
Troubleshoot specific warnings or errors in the cluster
Get detailed information about a particular host by name

Frequently asked questions

What prerequisites are needed to run Ceph MCP Server?

Python 3.11 or higher, the UV package manager, access to a Ceph cluster with Manager API enabled, and valid Ceph credentials with appropriate permissions.

How do I configure SSL for production use?

Set `CEPH_SSL_VERIFY=true` and optionally provide a custom certificate path via `CEPH_CERT_PATH`. For development, you can set `CEPH_SSL_VERIFY=false`.

What tools does the server provide?

Four tools: `get_cluster_health`, `get_host_status`, `get_health_details`, and `get_host_details` (which requires a hostname parameter).

How can I debug connection or authentication issues?

Enable debug logging by setting `LOG_LEVEL=DEBUG` before starting the server. Common issues include connection refused, authentication failures, SSL certificate errors, and permission denied problems.

Where are credentials stored and how should they be secured?

Credentials are set via environment variables in the `.env` file (never commit them to version control). In production, use a dedicated Ceph user with minimal required permissions and always enable SSL verification.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K