Ceph MCP Server

Name: Ceph MCP Server
Author: rajmohanram

@rajmohanram

代码仓库

关于 Ceph MCP Server

Ceph MCP Server

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

基本信息

分类

其他

运行时

python

传输方式

stdio

发布者

rajmohanram

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

FAQ from Ceph MCP Server

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.