Cluster Services

MCP服务器-群集服务

MCP服务器，用于发现TheClusterFlux Kubernetes集群中的集群服务并与之交互。

这有什么作用

此模型上下文协议（MCP）服务器使AI助手（如Cursor）能够：

• 发现部署在Kubernetes集群中的服务
• 了解API端点及其架构
• 检查服务运行状况
• 对测试终结点进行安全、只读的API调用
• 检索API文档

状态

✅ 准备部署 -实施完成

服务器可以在两种模式下运行：

• HTTP API模式 （建议用于共享访问）：部署到集群，开发人员使用API密钥通过HTTPS连接
• 标准模式 （用于本地开发）：在本地运行，Cursor直接启动进程

提供的工具

1. list_services -列出群集中的所有服务
2. get_service_info -获取详细的服务信息
3. get_service_health -检查服务运行状况
4. discover_endpoints -发现API端点
5. get_endpoint_schema -获取请求/响应模式
6. test_endpoint -进行安全的只读API调用
7. get_api_documentation -检索API文档

技术栈

• Types/Node.js
• 模型上下文协议SDK
• Express.js（用于HTTP API模式）
• Kubernetes客户端节点
• Axios用于HTTP请求

快速开始

对于开发人员（使用部署的HTTP API）

1. 从集群管理员处获取API密钥
2. 配置Cursor的MCP设置（请参阅 API_USAGE.md)
3. 开始使用Cursor中的工具！

促进地方发展

npm install
npm run build
npm start        # Stdio mode (for local Cursor integration)
npm run start:http  # HTTP mode (for testing)

文档

• API_USAGE.md -如何将Cursor连接到HTTP API
• 部署.md -如何部署到Kubernetes
• k8s-secret-example.yaml -API密钥秘密模板

安全

• 只读操作 -只有安全的HTTP方法（GET、HEAD、OPTIONS）
• API密钥验证 -默认情况下为故障安全（除非启用开发模式，否则需要密钥）
• 速率限制 -每个API密钥每分钟100个请求
• SSRF保护 -仅允许群集内部服务请求
• HTTPS强制 -仅接受HTTPS请求（开发人员的localhost除外）
• 输入验证 -所有输入都经过验证和消毒
• 错误清理 -无敏感信息错误泄露
• 请求大小限制 -最大有效载荷大小为1MB
• 跨域资源共享 -允许相同的域请求（用于未来的网站集成）