ArgoCD MCP Server (mcp-argocd)

ArgoCD의 주요 리소스(Application, Cluster, Project 등)를 제어하고 조회할 수 있는 Model Context Protocol (MCP) 서버입니다.

기능 (MCP Tools)

• argocd_list_applications: 애플리케이션 목록 조회 (필터 지원)
• argocd_get_application: 애플리케이션 상세 조회
• argocd_create_application: 애플리케이션 생성
• argocd_update_application: 애플리케이션 수정
• argocd_delete_application: 애플리케이션 삭제
• argocd_sync_application: 애플리케이션 동기화(Sync)
• argocd_list_clusters: 연동된 클러스터 목록 조회
• argocd_list_projects: 프로젝트 목록 조회

환경 변수

• ARGOCD_URL: ArgoCD 서버 주소 (예: https://argocd.example.com)
• ARGOCD_TOKEN: 인증 토큰 (Bearer Token)
• NODE_TLS_REJECT_UNAUTHORIZED: 0으로 설정 시 인증서 검증 우회 (기본값: 0)
• PORT: HTTP 서버 포트 (기본값: 3000)
• TRANSPORT: http 또는 sse 설정 시 HTTP 서버로 구동 (미설정 시 stdio)

실행 방법

로컬 실행 (npx)

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": ["-y", "git+https://gitlab.itapi.org/mcp/mcp_argocd.git#dev"],
      "env": {
        "ARGOCD_URL": "https://your-argocd-server.com",
        "ARGOCD_TOKEN": "your-token"
      }
    }
  }
}

Docker 실행 (HTTP / SSE)

cp .env.example .env
# .env 파일 수정 후
docker-compose up -d --build

이후 http://localhost:3000/mcp 엔드포인트를 통해 접근할 수 있습니다.