Cyclops MCP

1. Asegúrate de que Cyclops esté instalado en tu clúster de Kubernetes

Consulta nuestra documentación sobre cómo instalarlo con un solo comando - https://cyclops-ui.com/docs/installation/install/manifest

2. Descargar el servidor MCP

Puedes descargar el binario del servidor Cyclops MCP con el siguiente comando:

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

3. Agregar configuración del servidor

⚠️ Por defecto, Cyclops MCP utilizará el archivo .kube/config para conectarse a tu clúster

Configura tu servidor MCP Cyclops:

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

Configuración

Puedes configurar el servidor Cyclops MCP mediante variables de entorno. A continuación se muestra un ejemplo de cómo agregar la configuración para especificar el archivo kubeconfig que el servidor Cyclops MCP debe usar al gestionar tus aplicaciones Cyclops.

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

Variables de entorno

A continuación se muestra la lista de variables de entorno utilizadas para configurar tu servidor Cyclops MCP:

En lugar de que cada desarrollador instale el binario mcp-cyclops, puedes instalar el servidor Cyclops MCP con SSE como tipo de transporte en tu clúster de Kubernetes y permitir que todos tus desarrolladores se conecten al mismo servidor.

1. Antes de instalar, asegúrate de que Cyclops y todos sus CRDs estén instalados en tu clúster:

   1. Verifica que los pods de Cyclops estén en ejecución:

      kubectl get pods -n cyclops
      

      Debería mostrar:

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

   2. Verifica si los CRDs están instalados

      kubectl get crds | grep cyclops-ui
      

      Debería mostrar:

      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
      

2. Instala el servidor Cyclops MCP con el siguiente comando:

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

3. Ahora puedes exponer el servicio cyclops-mcp. Para probar tu servidor MCP, puedes reenviar el puerto:

   kubectl port-forward svc/cyclops-mcp -n cyclops 8000:8000
   

4. Agrega el host de tu servidor Cyclops MCP, o en caso de que lo estés probando, la dirección localhost donde reenviaste el puerto del servicio MCP:

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