Raj-prateek/cilium-document-mcp-server
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:
-
Search Cilium Documentation
mcp_fetch_search_cilium_docs({ query: "network policies", section: "security" // optional: all, installation, networking, security, observability, troubleshooting })
-
Get Configuration Examples
mcp_fetch_get_cilium_examples({ feature: "ingress" // network-policy, ingress, service-mesh, cluster-mesh, bgp })
-
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
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
License
MIT License