MCP Server

MCP server for Croit Ceph cluster management with dynamic OpenAPI tool generation

Local serverstdioPython

What is the MCP MCP server?

If you already use MCP, the mcp mcp server is the piece that lets your assistant work with it directly. MCP server for Croit Ceph cluster management with dynamic OpenAPI tool generation.

What the server does

Connect your AI assistant (like Claude) directly to your Croit Ceph cluster for intelligent cluster management, troubleshooting, and monitoring.

An MCP server that gives AI assistants access to your Croit Ceph cluster's REST API. Ask your AI to: - "Show me all pools with errors" - "List OSDs on server node-5" - "Search logs for slow requests in the last hour" - "What's the cluster health status?"

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • list_endpoints — Discover available API endpoints
  • call_endpoint — Make API calls with optimization
  • search_last_result — Drill down into large responses
  • manage_services — Ceph services
  • manage_pools — Storage pools
  • manage_servers — Cluster servers
  • manage_s3 — S3 buckets
  • croit_log_search — Advanced log analysis
  • croit_log_check — Quick log condition checks

Credentials and setup notes

Configuration is passed through the environment: CROIT_HOST, CROIT_API_TOKEN, LOG_LEVEL, YOUR_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of file and storage access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. MCP's toolset — list_endpoints, call_endpoint, search_last_result and 6 more — is a fair guide to whether it matches your workflow. It is maintained by croit; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
list_endpointsDiscover available API endpoints
call_endpointMake API calls with optimization
search_last_resultDrill down into large responses
manage_servicesCeph services
manage_poolsStorage pools
manage_serversCluster servers
manage_s3S3 buckets
croit_log_searchAdvanced log analysis
croit_log_checkQuick log condition checks

How to install the MCP MCP server

**With debug logging:**
```json
{
  "mcpServers": {
    "croit-ceph": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "CROIT_HOST=http://your-cluster.croit.io:8080",
        "-e", "CROIT_API_TOKEN=your-api-token-here",
        "-e", "LOG_LEVEL=DEBUG",
        "croit/mcp-croit-ceph:latest"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
CROIT_HOSTEndpoint or connection string the server talks to.Optional
CROIT_API_TOKENCredential the server authenticates with.Yes
LOG_LEVELConfiguration value read at startup.Optional
YOUR_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use MCP to list endpoints.
  • Use MCP to call endpoint.
  • Use MCP to search last result.

Frequently asked questions

It connects MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (list_endpoints, call_endpoint, search_last_result, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP directly.