argocd-mcp

Servidor MCP de Argo CD

Una implementación del servidor del Protocolo de Contexto de Modelo (MCP) para Argo CD , que permite a los asistentes de IA interactuar con sus aplicaciones de Argo CD mediante lenguaje natural. Este servidor permite una integración fluida con Visual Studio Code y otros clientes MCP mediante los protocolos de transporte stdio y Eventos Enviados por el Servidor (SSE).

Este proyecto es mantenido por Akuity , los creadores de Argo Project.

Akuity es la empresa de Argo y Kargo, y proporciona la plataforma esencial para GitOps integral para Kubernetes. Con la Plataforma Akuity, las empresas pueden implementar con Argo CD administrado, promover sin problemas con Kargo y obtener visibilidad en tiempo real de su infraestructura mediante Akuity Monitoring. Akuity fue fundada por los creadores de Argo, Hong Wang, Jesse Suen y Alexander Matyushentsev, con la misión de dotar a los equipos de Plataforma y Aplicación con las mejores herramientas para GitOps a escala empresarial.

Características

• Protocolos de transporte : admite los modos de transporte stdio y SSE para una integración flexible con diferentes clientes
• Integración completa de la API de Argo CD : proporciona acceso completo a los recursos y operaciones de Argo CD
• Asistente de IA listo : herramientas preconfiguradas para que los asistentes de IA interactúen con Argo CD en lenguaje natural

Instalación

Prerrequisitos

• Node.js (se recomienda v18 o superior)
• Gestor de paquetes pnpm (para desarrollo)
• Instancia de CD de Argo con acceso a API
• Token API de CD de Argo (consulte la documentación para obtener instrucciones )

Uso con cursor

1. Siga la documentación de Cursor para obtener compatibilidad con MCP y cree un archivo .cursor/mcp.json en su proyecto:

2. Inicie una conversación con el modo Agente para utilizar el MCP.

Uso con VSCode

1. Siga la documentación sobre el uso de servidores MCP en VS Code y cree un archivo .vscode/mcp.json en su proyecto:

2. Inicie una conversación con un asistente de IA en VS Code que admita MCP.

Uso con Claude Desktop

1. Siga el MCP en la documentación de Claude Desktop y cree un archivo de configuración claude_desktop_config.json :

2. Configure Claude Desktop para utilizar este archivo de configuración en la configuración.

Herramientas disponibles

El servidor proporciona las siguientes herramientas de administración de ArgoCD:

Gestión de aplicaciones

• list_applications : enumera y filtra todas las aplicaciones
• get_application : Obtener información detallada sobre una aplicación específica
• create_application : Crea una nueva aplicación
• update_application : Actualizar una aplicación existente
• delete_application : Eliminar una aplicación
• sync_application : activa una operación de sincronización en una aplicación

Gestión de recursos

• get_application_resource_tree : obtiene el árbol de recursos para una aplicación específica
• get_application_managed_resources : Obtener recursos administrados para una aplicación específica
• get_application_workload_logs : obtiene registros de las cargas de trabajo de las aplicaciones (pods, implementaciones, etc.)
• get_resource_events : Obtener eventos para recursos administrados por una aplicación
• get_resource_actions : Obtener las acciones disponibles para los recursos
• run_resource_action : Ejecutar una acción en un recurso

Para el desarrollo

1. Clonar el repositorio:

2. Instalar dependencias del proyecto:

3. Inicie el servidor de desarrollo con la recarga en caliente habilitada:

Una vez que el servidor esté en funcionamiento, puede utilizar el servidor MCP dentro de Visual Studio Code u otro cliente MCP.

Actualización de tipos de ArgoCD

Para actualizar las definiciones de tipos de TypeScript según la última especificación de la API de Argo CD:

1. Descargue el archivo swagger.json de la página de lanzamiento de ArgoCD , por ejemplo, aquí está el enlace swagger.json para ArgoCD v2.14.11.
2. Coloque el archivo swagger.json descargado en el directorio raíz del proyecto argocd-mcp .
3. Genere los tipos de TypeScript a partir de la definición de Swagger ejecutando el siguiente comando. Esto creará o sobrescribirá el archivo src/types/argocd.d.ts :
   pnpm run generate-types
4. Actualice el archivo src/types/argocd-types.ts para exportar los tipos necesarios desde el src/types/argocd.d.ts recién generado. Este paso suele requerir una revisión manual para garantizar que solo se expongan los tipos necesarios.