Argo CD MCP-сервер

Реализация сервера Model Context Protocol (MCP) для Argo CD , позволяющая помощникам AI взаимодействовать с вашими приложениями Argo CD посредством естественного языка. Этот сервер обеспечивает бесшовную интеграцию с Visual Studio Code и другими клиентами MCP через транспортные протоколы stdio и Server-Sent Events (SSE).

Этот проект поддерживается Akuity , создателями проекта Argo.

Akuity — это корпоративная компания для Argo и Kargo, которая предоставляет необходимую платформу для сквозного GitOps для Kubernetes. С помощью платформы Akuity предприятия могут развертывать с помощью управляемого Argo CD, беспрепятственно продвигать с помощью Kargo и получать видимость в реальном времени в своей инфраструктуре с помощью Akuity Monitoring. Akuity была основана создателями Argo Хонгом Ваном, Джесси Суеном и Александром Матюшенцевым с целью предоставить командам платформы и приложения лучшие инструменты для GitOps в масштабе предприятия.

Функции

• Транспортные протоколы : поддерживаются транспортные режимы stdio и SSE для гибкой интеграции с различными клиентами.

• Полная интеграция API Argo CD : обеспечивает полный доступ к ресурсам и операциям Argo CD.

• Готовность к использованию помощника на основе искусственного интеллекта : предварительно настроенные инструменты для помощников на основе искусственного интеллекта для взаимодействия с Argo CD на естественном языке.

Установка

Предпосылки

• Node.js (рекомендуется v18 или выше)

• менеджер пакетов pnpm (для разработки)

• Экземпляр Argo CD с доступом по API

• Токен API Argo CD ( инструкции см. в документации )

Использование с курсором

1. Следуйте документации по Cursor для поддержки MCP и создайте файл .cursor/mcp.json в своем проекте:

2. Начните разговор в режиме агента, чтобы использовать MCP.

Использование с VSCode

1. Следуйте документации Использование серверов MCP в VS Code и создайте файл .vscode/mcp.json в своем проекте:

2. Начните разговор с помощником на основе искусственного интеллекта в VS Code, который поддерживает MCP.

Использование с Claude Desktop

1. Следуя MCP в документации Claude Desktop , создайте файл конфигурации claude_desktop_config.json :

2. Настройте Claude Desktop для использования этого файла конфигурации в настройках.

Доступные инструменты

Сервер предоставляет следующие инструменты управления ArgoCD:

Управление приложениями

• list_applications : Список и фильтрация всех приложений

• get_application : Получить подробную информацию о конкретном приложении

• create_application : Создать новое приложение

• update_application : Обновить существующее приложение

• delete_application : Удалить приложение

• sync_application : Запуск операции синхронизации в приложении

Управление ресурсами

• get_application_resource_tree : Получить дерево ресурсов для определенного приложения

• get_application_managed_resources : Получить управляемые ресурсы для определенного приложения

• get_application_workload_logs : получение журналов для рабочих нагрузок приложений (модули, развертывания и т. д.)

• get_resource_events : Получить события для ресурсов, управляемых приложением

• get_resource_actions : Получить доступные действия для ресурсов

• run_resource_action : Выполнить действие над ресурсом

Для развития

1. Клонируйте репозиторий:

2. Установите зависимости проекта:

3. Запустите сервер разработки с включенной горячей перезагрузкой:

После запуска сервера вы можете использовать сервер MCP в Visual Studio Code или другом клиенте MCP.

Обновление типов ArgoCD

Чтобы обновить определения типов TypeScript на основе последней спецификации API Argo CD:

1. Загрузите файл swagger.json со страницы релиза ArgoCD , например, вот ссылка на swagger.json для ArgoCD v2.14.11.

2. Поместите загруженный файл swagger.json в корневой каталог проекта argocd-mcp .

3. Сгенерируйте типы TypeScript из определения Swagger, выполнив следующую команду. Это создаст или перезапишет файл src/types/argocd.d.ts :

   pnpm run generate-types

4. Обновите файл src/types/argocd-types.ts для экспорта требуемых типов из вновь созданного src/types/argocd.d.ts . Этот шаг часто требует ручного просмотра, чтобы убедиться, что отображаются только необходимые типы.