cilium-document-mcp-server

Raj-prateek/cilium-document-mcp-server

3.1

If you are the rightful owner of cilium-document-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server providing comprehensive Cilium networking documentation, examples, and troubleshooting guidance.

Cilium Documentation MCP Server

A Model Context Protocol (MCP) server that provides comprehensive Cilium networking documentation, examples, and troubleshooting guidance. This server is designed to help with Cilium deployments, migrations (especially from HAProxy to Cilium Envoy), and operational tasks.

Features

  • Cilium Documentation Search: Search through Cilium docs by section (installation, networking, security, observability, troubleshooting)
  • Configuration Examples: Get practical examples for network policies, ingress, service mesh, cluster mesh, and BGP
  • Troubleshooting Support: Get specific troubleshooting steps for Cilium-related issues
  • Migration Guidance: Specialized support for migrating from traditional ingress controllers to Cilium Envoy

Cilium Envoy Migration Support

This MCP server provides specialized guidance for migrating from HAProxy Ingress Controller to Cilium Envoy, including:

Internal Architecture Understanding

  • Control Plane vs Data Plane components
  • eBPF integration and fast path processing
  • xDS API configuration management
  • Service discovery and endpoint management

Migration Scenarios

  • Basic Ingress Migration: Convert HAProxy ingress resources to Cilium
  • Advanced Load Balancing: Custom load balancing algorithms and health checks
  • SSL/TLS Configuration: TLS termination and certificate management
  • Rate Limiting: Migrate rate limiting policies from HAProxy to Envoy
  • Observability: Set up monitoring and metrics collection

Common Migration Issues

  • Configuration format differences (ConfigMap vs CRDs)
  • Performance optimization strategies
  • SSL/TLS handling changes
  • Monitoring and alerting setup

Installation

npm install
npm run build

Usage

The server provides three main functions:

  1. Search Cilium Documentation

    mcp_fetch_search_cilium_docs({
      query: "network policies",
      section: "security" // optional: all, installation, networking, security, observability, troubleshooting
    })
    
  2. Get Configuration Examples

    mcp_fetch_get_cilium_examples({
      feature: "ingress" // network-policy, ingress, service-mesh, cluster-mesh, bgp
    })
    
  3. Get Troubleshooting Help

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

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

Project Structure

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

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

License

MIT License