cyclops-ui/mcp-cyclops

30 stars 7 forks Quality 46 Trend 25

Model Context Protocol server for Cyclops

Overview

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. 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.

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:
```
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:
```
{
  "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.

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

View this README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide

Configuration

{
      "mcpServers": {
        "cyclops-kubernetes": {
          "url": "http://localhost:8000/sse"
        }
      }
    }