Cilium文档MCP服务器

一个提供全面Cilium网络文档、示例和故障排除指导的模型上下文协议服务器,适用于Cilium部署、迁移和运维任务。

  • by Raj-prateek
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 raj-prateek/cilium-document-mcp-server

使用说明

Cilium文档MCP服务器

一种模型上下文协议(MCP)服务器,提供全面的Cilium网络文档、示例和故障排除指导。此服务器旨在帮助Cilium部署、迁移(特别是从HAProxy到Cilium Envoy)和操作任务。

特性

  • Cilium文档搜索:按部分搜索Cilium文档(安装、网络、安全、可观察性、故障排除)
  • 配置示例:获取网络策略、入口、服务网格、集群网格和BGP的实际示例
  • 故障排除支持:获取Cilium相关问题的具体故障排除步骤
  • 迁移指导:为从传统入口控制器迁移到Cilium Envoy提供专业支持

Cilium Envoy迁移支持

此MCP服务器为从HAProxy入口控制器迁移到Cilium Envoy提供了专门的指导,包括:

内部架构理解

  • 控制平面与数据平面组件
  • eBPF集成和快速路径处理
  • xDS API配置管理
  • 服务发现和端点管理

迁移场景

  • 基本入口迁移:将HAProxy入口资源转换为Cilium
  • 高级负载平衡:自定义负载平衡算法和健康检查
  • SSL/TLS配置:TLS终止和证书管理
  • 速率限制:将速率限制策略从HAProxy迁移到Envoy
  • 可观测性:设置监控和指标收集

常见的迁移问题

  • 配置格式差异(ConfigMap与CRD)
  • 性能优化策略
  • SSL/TLS处理更改
  • 监控和警报设置

安装

npm install
npm run build

用法

服务器提供三个主要功能:

  1. 搜索Cilium文档

    mcp_fetch_search_cilium_docs({
      query: "network policies",
      section: "security" // optional: all, installation, networking, security, observability, troubleshooting
    })
    
  2. 获取配置示例

    mcp_fetch_get_cilium_examples({
      feature: "ingress" // network-policy, ingress, service-mesh, cluster-mesh, bgp
    })
    
  3. 获取故障排除帮助

    mcp_fetch_get_cilium_troubleshooting({
      issue: "Cilium Envoy proxy not working service mesh configuration"
    })
    

发展

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

项目结构

├── src/
│   └── index.ts          # Main MCP server implementation
├── build/                # Compiled output
├── package.json
├── tsconfig.json
└── README.md

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

许可证

MIT许可证