Kubernetes集群服务发现工具

MCP Server是一个用于发现和交互Kubernetes集群服务的工具,提供API端点发现、健康检查和安全只读API调用功能。

  • by TheClusterFlux
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 TheClusterFlux/mcp-server-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)

文档

安全

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