iflow-mcp_rajmohanram_ceph-mcp-server

# Ceph MCP Server A Model Context Protocol (MCP) server that enables AI assistants to interact with Ceph storage clusters through natural language. This server provides a bridge between AI tools and your Ceph infrastructure, making storage management more accessible and intuitive. ## 🚀 Features - **Health Monitoring**: Get comprehensive cluster health status and diagnostics - **Host Management**: Monitor and manage cluster hosts and their services - **Detailed Analysis**: Access detailed health checks for troubleshooting - **Secure Communication**: Authenticated access to Ceph Manager API - **Structured Responses**: AI-friendly output formatting for clear communication - **Async Architecture**: Non-blocking operations for better performance ## 📋 Prerequisites - Python 3.11 or higher - UV package manager - Access to a Ceph cluster with Manager API enabled - Valid Ceph credentials with appropriate permissions ## 🛠️ Installation 1. **Clone and setup the project:** ```bash # Create the project directory mkdir ceph-mcp-server cd ceph-mcp-server # Initialize UV project uv init --python 3.11 # Add dependencies uv add mcp httpx pydantic python-dotenv structlog asyncio-mqtt uv add --dev pytest pytest-asyncio black isort mypy ruff ``` 2. **Set up your environment:** ```bash # Copy the example environment file cp .env.example .env # Edit .env with your Ceph cluster details nano .env ``` 3. **Configure your Ceph connection:** ```bash # .env file contents CEPH_MANAGER_URL=https://192.16.0.31:8443 CEPH_USERNAME=admin CEPH_PASSWORD=your_ceph_password CEPH_SSL_VERIFY=false # Set to true in production with proper certificates ``` ## 🏃‍♂️ Quick Start 1. **Start the MCP server:** ```bash uv run python -m ceph_mcp.server ``` 2. **Test the connection:** The server will log its startup and any connection issues. Look for messages indicating successful connection to your Ceph cluster. ## 🔧 Configuration ### Environment Variables | Variable | Description | Default …