
Mcp Croit Ceph
io.github.croit由 GitHub 账号 croit 发布v0.2.16更新于 Oct 24, 2026
MCP server for Croit Ceph cluster management with dynamic OpenAPI tool generation
概览
将 AI 助手连接到 Croit Ceph 集群的 REST API,可用自然语言查看存储池、OSD、服务器、S3 桶和日志。
- 可以做什么
- 发现并调用集群 API 端点,支持字段筛选、过滤以及对大响应的下钻查询
- 通过自动生成的分类工具管理 Ceph 服务、存储池、服务器和 S3 桶
- 借助 VictoriaLogs 集成搜索和检查集群日志,包括模式与异常识别
- 对大结果集生成摘要并缓存重复请求,以降低 token 消耗
- 适用场景
- 适合管理 Croit 托管的 Ceph 集群的运维人员,希望让助手回答健康状态、容量规划和故障排查问题,或执行日常读取操作而无需在网页界面中逐项点击。
- 运行要求
- 以 Docker 容器(镜像 croit/mcp-croit-ceph)或 Python 源码在本地运行。需要 CROIT_HOST 集群地址和在 Croit 网页界面创建的 CROIT_API_TOKEN,并需能访问集群网络。可选配置 OPENAPI_FILE、USE_INCLUDED_API_SPEC、LOG_LEVEL 和 MCP_ARGS。
安装
在 SourceWeft 中
- 打开 控制台中的 Mcp Croit Ceph,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
MCP Croit Ceph
AI-powered management for Croit Ceph clusters via the Model Context Protocol (MCP)
Connect your AI assistant (like Claude) directly to your Croit Ceph cluster for intelligent cluster management, troubleshooting, and monitoring.
What is this?
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?"
The AI can then interact with your cluster through natural language.
Key Features
🚀 Smart & Efficient
- Automatic token optimization - Responses optimized to save 80-95% on AI token costs
- Field selection - Request only the data you need (e.g., just id + name)
- Built-in filtering - grep-like search without multiple API calls
- Intelligent summaries - Large datasets get smart summaries with drill-down capability
🔍 Advanced Log Search
- Native VictoriaLogs integration for powerful log analysis
- Natural language queries: "Find OSD failures in the last 24 hours"
- Pattern detection and anomaly identification
- Pre-built debug templates for common issues
🛡️ Production Ready
- Role-based access control (ADMIN vs VIEWER)
- Automatic API discovery from your cluster
- Docker support with included OpenAPI spec
- Comprehensive error handling
Quick Start
Using Docker (Recommended)
With Claude Desktop
Add to ~/.config/claude/claude_desktop_config.json:
Basic configuration (fetches OpenAPI spec on startup):
Optimized configuration (recommended - 2s startup instead of 5s):
With debug logging:
Note: Volume mounts require absolute paths (not ~/). To download the OpenAPI spec:
Restart Claude Desktop after changing the configuration.
Configuration
Required Environment Variables
Optional Environment Variables
See .env.example for docker usage template.
Getting an API Token
- Log into your Croit cluster web interface
- Go to Settings → API Tokens
- Create a new token with appropriate permissions
- Copy the token and use it in your configuration
Example AI Conversations
Check cluster health:
Find problems:
Debug issues:
Capacity planning:
Features in Detail
Token Optimization
The server automatically reduces AI token consumption:
How it works:
- Field Selection: Request only needed fields
- Smart Summaries: Large datasets get summaries with drill-down
- Caching: Repeated requests use cached data
- Auto-limiting: Sensible defaults prevent token explosions
Available Tools
The AI has access to these tools:
Core Tools:
list_endpoints- Discover available API endpointscall_endpoint- Make API calls with optimizationsearch_last_result- Drill down into large responses
Category Tools (auto-generated):
manage_services- Ceph servicesmanage_pools- Storage poolsmanage_servers- Cluster serversmanage_s3- S3 buckets- And more...
Log Search:
croit_log_search- Advanced log analysiscroit_log_check- Quick log condition checks
Advanced Usage
Local Development
Using Local OpenAPI Spec
For faster startup or offline development:
Command Line Options
Permissions & Security
The server respects your API token's role:
- ADMIN: Full access to all operations
- VIEWER: Read-only access (no create/delete/update)
- Invalid token: Server exits with error
Admin-only categories: maintenance, servers, config, hooks
Troubleshooting
Token not working:
- Verify token in Croit web interface
- Check token hasn't expired
- Ensure token has correct permissions
Connection issues:
- Verify
CROIT_HOSTis correct (include https://) - Check network connectivity to cluster
- Verify firewall allows connection
No tools showing:
- Check Docker logs for errors
- Verify OpenAPI spec is valid
- Try
--no-permission-checkto test
Enable debug logging:
Documentation
- Architecture - Technical architecture and design
- Token Optimization - How optimization works
- Claude Integration - Tips for using with Claude
Contributing
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Run
blackformatter on Python files - Submit a pull request
License
See LICENSE for details
Support
- Issues: GitHub Issues
- Croit Support: For cluster-specific questions
- MCP Protocol: Model Context Protocol Documentation
Made with ❤️ for the Ceph community
来源:README.md,提交 cebfa2e
工具
0版本历史
1- v0.2.16最新Sep 16, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。