argocd-mcp

Argo CD MCP 서버

Argo CD 용 모델 컨텍스트 프로토콜(MCP) 서버 구현으로, AI 어시스턴트가 자연어를 통해 Argo CD 애플리케이션과 상호 작용할 수 있도록 지원합니다. 이 서버는 stdio 및 SSE(Server-Sent Events) 전송 프로토콜을 통해 Visual Studio Code 및 기타 MCP 클라이언트와 원활하게 통합됩니다.

이 프로젝트는 Argo Project의 제작자인 Akuity가 관리하고 있습니다.

Akuity는 Argo와 Kargo의 엔터프라이즈 기업으로, 쿠버네티스를 위한 엔드투엔드 GitOps를 위한 필수 플랫폼을 제공합니다. Akuity 플랫폼을 통해 기업은 관리형 Argo CD를 통해 배포하고, Kargo를 통해 원활하게 홍보하며, Akuity Monitoring을 통해 인프라에 대한 실시간 가시성을 확보할 수 있습니다. Akuity는 Argo의 창립자인 Hong Wang, Jesse Suen, Alexander Matyushentsev가 설립했으며, 플랫폼 팀과 애플리케이션 팀 모두에게 엔터프라이즈 규모의 GitOps를 위한 최고의 도구를 제공한다는 사명을 가지고 있습니다.

특징

• 전송 프로토콜 : 다양한 클라이언트와의 유연한 통합을 위해 stdio 및 SSE 전송 모드를 모두 지원합니다.
• Argo CD API 통합 완료 : Argo CD 리소스 및 운영에 대한 포괄적인 액세스를 제공합니다.
• AI Assistant Ready : AI 도우미가 자연어로 Argo CD와 상호 작용할 수 있도록 미리 구성된 도구

설치

필수 조건

• Node.js(v18 이상 권장)
• pnpm 패키지 관리자(개발용)
• API 액세스를 통한 Argo CD 인스턴스

커서를 사용한 사용

1. MCP 지원을 위한 커서 설명서를 따르고 프로젝트에 .cursor/mcp.json 파일을 만드세요.

지엑스피1

2. MCP를 사용하려면 에이전트 모드로 대화를 시작하세요.

VSCode와 함께 사용

1. VS Code에서 MCP 서버 사용 설명서를 따르고 프로젝트에 .vscode/mcp.json 파일을 만듭니다.

2. MCP를 지원하는 VS Code의 AI 비서와 대화를 시작하세요.

Claude Desktop과 함께 사용

1. Claude Desktop 설명서의 MCP를 따르고 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 : 애플리케이션 워크로드(Pod, 배포 등)에 대한 로그를 가져옵니다.
• get_resource_events : 애플리케이션에서 관리하는 리소스에 대한 이벤트를 가져옵니다.
• get_resource_actions : 리소스에 사용 가능한 작업 가져오기
• run_resource_action : 리소스에 대한 작업을 실행합니다.

개발을 위해

1. 저장소를 복제합니다.

2. 프로젝트 종속성 설치:

3. 핫 리로딩을 활성화하여 개발 서버를 시작합니다.

서버가 실행되면 Visual Studio Code나 다른 MCP 클라이언트에서 MCP 서버를 활용할 수 있습니다.

ArgoCD 유형 업그레이드

최신 Argo CD API 사양에 따라 TypeScript 유형 정의를 업데이트하려면 다음을 수행합니다.

1. ArgoCD 릴리스 페이지 에서 swagger.json 파일을 다운로드하세요. 예를 들어, ArgoCD v2.14.11의 swagger.json 링크는 다음과 같습니다.
2. 다운로드한 swagger.json 파일을 argocd-mcp 프로젝트의 루트 디렉토리에 넣습니다.
3. 다음 명령을 실행하여 Swagger 정의에서 TypeScript 유형을 생성하세요. 이렇게 하면 src/types/argocd.d.ts 파일이 생성되거나 덮어쓰여집니다.
   pnpm run generate-types
4. 새로 생성된 src/types/argocd-types.ts``src/types/argocd.d.ts types.ts 파일을 업데이트합니다. 이 단계에서는 필요한 유형만 노출되도록 수동으로 검토해야 하는 경우가 많습니다.