mcp-cyclops

Abstract Kubernetes complexity for AI agents with Model Context Protocol.

Stars

Forks

Watchers

Issues

Cyclops MCP enables AI agents to safely manage Kubernetes applications by providing a Model Context Protocol (MCP) server. It abstracts Kubernetes resources into high-level Cyclops Modules, reducing the risk of misconfiguration and streamlining application deployment and updates. The server offers tools for creating, updating, and managing modules and templates, and integrates easily with popular AI agent interfaces.

Key Features

Model Context Protocol (MCP) server for Kubernetes

High-level abstraction with Cyclops Modules

Tools for creating, listing, fetching, and updating modules

Template schema validation before deployments

Integration-ready for AI agents via standardized configuration

Environment variable-based configuration

Supports binary and Kubernetes cluster installation

Centralized management of application templates

Port forwarding and cluster exposure support

Namespace and context customization

Use Cases

Automating Kubernetes application deployment via AI agents

Reducing the risk of misconfiguration in production clusters

Centralized management and updating of Kubernetes application templates

Allowing developers and AI agents to operate Kubernetes resources without direct YAML manipulation

Ensuring validated, production-ready application schemas before deployment

Providing a shared MCP gateway for multiple developers in a team

Quickly onboarding new applications through an abstracted workflow

Integrating AI-driven DevOps pipelines with Kubernetes environments

Simplifying Kubernetes access management for AI interfaces

Managing Helm releases and module namespaces via high-level protocols

README

Cyclops MCP (Model Context Protocol)

Cyclops MCP allows your favorite AI agent to manage your Kubernetes applications. Cyclops MCP servers provide tools for agents to create and update existing applications safely.

https://github.com/user-attachments/assets/0c675c33-1e36-4fdb-bf8c-2fd7fb491e6b

This means it can check all of your existing templates and the schema of those templates to create accurate and production-ready applications. Your agent now has much less room to make a misconfiguration since it creates high-level resources (Cyclops Modules) instead of touching every line of your Kubernetes resources (Deployments, Services, and Ingresses).

It allows you to move fast and ensure no uncaught misconfigurations are hitting your production.

With Cyclops and our MCP, you can now abstract Kubernetes complexity from your developers AND your AI agents

Install via UI

The easiest way to install the Cyclops MCP server is through the Cyclops UI. Below are instructions on how to install it via binary and kubectl, but the recommended way of installing it is via the UI.

⚠️ To install Cyclops MCP through the UI, you should run Cyclops on a version v0.20.1 or greater

Install the Cyclops MCP by going to sidebar “Addon” > "MCP server". You can now click "Install Cyclops MCP server" and your Cyclops MCP server will be up and running in a few seconds.

Now that your MCP server is up running, all thats left is exposing it outside of your cluster and connecting your AI agent to it.

To expose the MCP server on localhost you can simply port-forward it with the following command:
bash
```
kubectl port-forward -n cyclops svc/cyclops-mcp 8000:8000
```
Your server is now available on localhost:8000.
To connect it to an AI agent you will just have to provide the Cyclops MCP server in its configuration. For example, to add it to Cursor, you can simply add it with the following JSON:
bash
```
{
  "mcpServers": {
    "cyclops-kubernetes": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

You can now start a fresh conversation with your AI companion. Above is an example of how we used it with Cursor.

1. Make sure Cyclops is installed in your Kubernetes cluster

Check our docs on how it install it with a single command - https://cyclops-ui.com/docs/installation/install/manifest

2. Download MCP server

You can download the Cyclops MCP server binary with the following command:

yaml

GOBIN="$HOME/go/bin" go install github.com/cyclops-ui/mcp-cyclops/cmd/mcp-cyclops@latest

3. Add server configuration

⚠️ By default, Cyclops MCP will use the .kube/config file to connect to your cluster

Configure your MCP Cyclops server:

json

{
  "mcpServers": {
    "mcp-cyclops": {
      "command": "mcp-cyclops"
    }
  }
}

Configuration

You can configure Cyclops MCP server via env variables. Below is an example of adding the configuration for specifying the kubeconfig file the Cyclops MCP server should use when managing your Cyclops applications.

json

{
  "mcpServers": {
    "mcp-cyclops": {
      "command": "mcp-cyclops",
      "env": {
        "KUBECONFIG": "/path/to/your/kubeconfig"
      }
    }
  }
}

Environment variables

Below is the list of environment variables used for configuring your Cyclops MCP server:

Env var	Description
`KUBECONFIG`	Path to kubeconfig file (optional, defaults to in-cluster config or $HOME/.kube/config)
`CYCLOPS_KUBE_CONTEXT`	Kubernetes context to use (optional)
`CYCLOPS_MODULE_NAMESPACE`	Namespace where modules are stored
`CYCLOPS_HELM_RELEASE_NAMESPACE`	Namespace for Helm releases
`CYCLOPS_MODULE_TARGET_NAMESPACE`	Target namespace for modules

Instead of having each developer install mcp-cyclops binary, you can install the Cyclops MCP server with SSE as transport type to your Kubernetes cluster and allow all of your developers to connect to the same server.

Before installing, make sure Cyclops and all its CRDs are installed in your cluster:

Check Cyclops pods are running:

shell

kubectl get pods -n cyclops

Should write:

NAME                            READY   STATUS    RESTARTS   AGE
cyclops-ctrl-676b5d9789-ntcls   1/1     Running   0          94s
cyclops-ui-7798655f97-xdg29     1/1     Running   0          94s

Check if CRDs are installed

shell

kubectl get crds | grep cyclops-ui

Should write:

modules.cyclops-ui.com             2025-04-26T15:28:18Z
templateauthrules.cyclops-ui.com   2025-04-26T15:28:18Z
templatestores.cyclops-ui.com      2025-04-26T15:28:18Z

Install Cyclops MCP server with the following command:

shell

kubectl apply -f https://raw.githubusercontent.com/cyclops-ui/mcp-cyclops/refs/heads/main/install/mcp-server.yaml

You can now expose the cyclops-mcp service. To test your MCP server, you can port-forward it:
shell
```
kubectl port-forward svc/cyclops-mcp -n cyclops 8000:8000
```
Add your Cyclops MCP server host, or in case you are testing it, the localhost address where you port-forwarded the MCP service:
json
```
{
  "mcpServers": {
    "mcp-cyclops": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

Tools

Tool	Description
`create_module`	Create new Module. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template
`get_module`	Fetch Module by name
`list_modules`	List all Cyclops Modules
`update_module`	Update Module by Name. Before calling this tool, make sure to call `get_template_schema` to validate values for the given template
`get_template_schema`	Returns JSON schema for the given template. Needs to be checked before calling `create_module` tool
`get_template_store`	Fetch Template Store by Name
`list_template_store`	List Template Stores from cluster

Star History

Repository Owner

cyclops-ui

Organization

Repository Details

Language Go

Default Branch main

Size 96 KB

Contributors 2

MCP Verified Sep 5, 2025

Programming Languages

97.77%

Dockerfile

1.51%

Makefile

0.72%

Topics

cyclops devops kubernetes mcp mcp-server platform-engineering

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

Related MCPs

Discover similar Model Context Protocol servers

k8s-mcp-server

Securely enable Claude to run Kubernetes CLI tools via Anthropic's Model Context Protocol.

K8s MCP Server provides a Docker-based implementation of Anthropic's Model Context Protocol (MCP), allowing Claude to securely execute Kubernetes CLI tools such as kubectl, helm, istioctl, and argocd within a containerized environment. It integrates with Claude Desktop so users can interact with their Kubernetes clusters using natural language. The server emphasizes security by operating as a non-root user and offering strict command validation, while also supporting major cloud providers like AWS, Google Cloud, and Azure. Easy configuration and support for various Unix tools further enhance its capabilities.

⭐ 166
MCP
alexei-led/k8s-mcp-server

mcp-server-templates

Deploy Model Context Protocol servers instantly with zero configuration.

MCP Server Templates enables rapid, zero-configuration deployment of production-ready Model Context Protocol (MCP) servers using Docker containers and a comprehensive CLI tool. It provides a library of ready-made templates for common integrations—including filesystems, GitHub, GitLab, and Zendesk—and features intelligent caching, smart tool discovery, and flexible configuration options via JSON, YAML, environment variables, or CLI. Perfect for AI developers, data scientists, and DevOps teams, it streamlines the process of setting up and managing MCP servers and has evolved into the MCP Platform for enhanced capabilities.

⭐ 5
MCP
Data-Everything/mcp-server-templates

awslabs/mcp

Specialized MCP servers for seamless AWS integration in AI and development environments.

AWS MCP Servers is a suite of specialized servers implementing the open Model Context Protocol (MCP) to bridge large language model (LLM) applications with AWS services, tools, and data sources. It provides a standardized way for AI assistants, IDEs, and developer tools to access up-to-date AWS documentation, perform cloud operations, and automate workflows with context-aware intelligence. Featuring a broad catalog of domain-specific servers, quick installation for popular platforms, and both local and remote deployment options, it enhances cloud-native development, infrastructure management, and workflow automation for AI-driven tools. The project includes Docker, Lambda, and direct integration instructions for environments such as Amazon Q CLI, Cursor, Windsurf, Kiro, and VS Code.

⭐ 6,220
MCP
awslabs/mcp

1mcp-app/agent

A unified server that aggregates and manages multiple Model Context Protocol servers.

1MCP Agent provides a single, unified interface that aggregates multiple Model Context Protocol (MCP) servers, enabling seamless integration and management of external tools for AI assistants. It acts as a proxy, managing server configuration, authentication, health monitoring, and dynamic server control with features like asynchronous loading, tag-based filtering, and advanced security options. Compatible with popular AI development environments, it simplifies setup by reducing redundant server instances and resource usage. Users can configure, monitor, and scale model tool integrations across various AI clients through easy CLI commands or Docker deployment.

⭐ 96
MCP
1mcp-app/agent

cloudflare/mcp-server-cloudflare

Connect Cloudflare services to Model Context Protocol (MCP) clients for AI-powered management.

Cloudflare MCP Server enables integration between Cloudflare's suite of services and clients using the Model Context Protocol (MCP). It provides multiple specialized servers that allow AI models to access, analyze, and manage configurations, logs, analytics, and other features across Cloudflare's platform. Users can leverage natural language interfaces in compatible MCP clients to read data, gain insights, and perform automated actions on their Cloudflare accounts. This project aims to streamline the orchestration of security, development, monitoring, and infrastructure tasks through standardized MCP connections.

⭐ 2,919
MCP
cloudflare/mcp-server-cloudflare

View all Alternatives

Didn't find tool you were looking for?

Search AI Tools

mcp-cyclops

Key Features

Use Cases

README

Cyclops MCP (Model Context Protocol)

Install via UI

1. Make sure Cyclops is installed in your Kubernetes cluster

2. Download MCP server

3. Add server configuration

Configuration

Environment variables

Tools

Star History

Repository Owner

Repository Details

Programming Languages

Topics

Related MCPs