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 в масштабе предприятия.

argocd-mcp-demo

Функции

Транспортные протоколы : поддерживаются транспортные режимы stdio и SSE для гибкой интеграции с различными клиентами.
Полная интеграция API Argo CD : обеспечивает полный доступ к ресурсам и операциям Argo CD.
Готовность к использованию помощника на основе искусственного интеллекта : предварительно настроенные инструменты для помощников на основе искусственного интеллекта для взаимодействия с Argo CD на естественном языке.

Related MCP server: Dingo MCP Server

Установка

Предпосылки

Node.js (рекомендуется v18 или выше)
менеджер пакетов pnpm (для разработки)
Экземпляр Argo CD с доступом по API
Токен API Argo CD ( инструкции см. в документации )

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

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

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

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

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

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

{
  "servers": {
    "argocd-mcp-stdio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

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

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

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

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

Настройте 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 : Выполнить действие над ресурсом

Для развития

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

git clone https://github.com/akuity/argocd-mcp.git
cd argocd-mcp

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

pnpm install

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

# For HTTP mode with hot reloading
pnpm run dev

# For SSE mode with hot reloading
pnpm run dev-sse

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

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

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

Загрузите файл swagger.json со страницы релиза ArgoCD , например, вот ссылка на swagger.json для ArgoCD v2.14.11.
Поместите загруженный файл swagger.json в корневой каталог проекта argocd-mcp .
Сгенерируйте типы TypeScript из определения Swagger, выполнив следующую команду. Это создаст или перезапишет файл src/types/argocd.d.ts :
```
pnpm run generate-types
```
Обновите файл src/types/argocd-types.ts для экспорта требуемых типов из вновь созданного src/types/argocd.d.ts . Этот шаг часто требует ручного просмотра, чтобы убедиться, что отображаются только необходимые типы.

argocd-mcp