Repolode
제출하기
zereight

zereight/gitlab-mcp

AI 어시스턴트가 GitLab 프로젝트, 머지 리퀘스트, 이슈, 파이프라인, 위키 등을 다룰 수 있도록 구조화된 도구를 제공하는 MCP 서버입니다.

GitHub에서 보기웹사이트
스타
2,086
포크
365
열린 이슈
11
마지막 커밋
어제

어떤 프로젝트인가요?

gitlab-mcp는 Claude, Cursor, VS Code, Copilot 같은 AI 클라이언트를 GitLab 인스턴스에 연결하는 Model Context Protocol 서버입니다. GitLab REST 및 GraphQL API를 기반으로 프로젝트, 머지 리퀘스트, 이슈, 파이프라인, 위키, 릴리스, 태그, 마일스톤을 다루는 약 280개의 도구를 제공합니다. 기본적으로는 약 40개의 핵심 도구만 로드하고, 세션 중에 추가 도구 모음을 활성화할 수 있어 모델이 다루는 도구 목록을 간결하게 유지합니다.

서버는 로컬 클라이언트용 stdio와 공유 또는 호스팅 배포용 Streamable HTTP, SSE로 실행됩니다. 인증 방식으로는 개인 액세스 토큰, 로컬 OAuth2 브라우저 플로, 원격 클라이언트용 MCP OAuth 프록시, 요청별 토큰 전달을 지원합니다. 권한 모드(readonly, modify, full), 도구 허용 및 차단 필터, 그룹 또는 프로젝트 제한을 통해 에이전트가 변경할 수 있는 범위를 제한합니다.

머지 리퀘스트 검토는 변경된 파일 목록을 가져온 다음 diff를 묶음 단위로 가져오는 2단계 흐름으로 진행됩니다. 선택 사항인 JMESPath 필터링과 결과 압축 기능으로 큰 응답의 크기를 줄일 수 있습니다. 동일한 바이너리는 diff와 작업 로그 같은 전체 페이로드를 다루는 CLI도 제공하며, GitLab.com과 자체 관리형 인스턴스 모두에서 작동합니다.

핵심 기능

  • 01프로젝트, 머지 리퀘스트, 이슈, 파이프라인, 위키, 릴리스를 위한 약 280개 도구
  • 02기본 도구 모음은 간결하게 유지하고 필요한 경우 추가 도구를 활성화
  • 03stdio, SSE, Streamable HTTP 전송 방식
  • 04개인 액세스 토큰, OAuth2, 요청별 원격 인증 지원
  • 05도구 및 프로젝트 필터를 적용할 수 있는 readonly 및 modify 권한 모드
  • 06diff를 묶음 단위로 가져오는 2단계 머지 리퀘스트 검토

활용 사례

  • AI 코딩 어시스턴트에게 머지 리퀘스트의 변경 파일과 diff 검토 요청
  • 에이전트가 GitLab 파이프라인 작업 로그를 확인하거나 CI 작업을 실행하도록 설정
  • 사용자별 토큰을 사용해 팀에서 호스팅된 GitLab MCP 엔드포인트 하나를 공유
  • 리포팅 또는 분류 작업을 위해 읽기 전용 GitLab 연동 운영

빠른 시작

  1. 1

    npm에서 바이너리를 설치합니다

    npm install -g @zereight/mcp-gitlab
  2. 2

    GitLab 개인 액세스 토큰을 설정합니다(입력 내용은 화면에 표시되지 않습니다)

    read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN
  3. 3

    Claude Code에 서버를 등록합니다

    claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab

사용 전 알아둘 점

  • 기본 도구 세트에는 약 40개의 도구만 표시되며, 나머지는 discover_tools로 활성화해야 합니다.
  • api 도구 세트는 허용 목록과 안전성 검사를 우회하므로 위험합니다.

포함된 컬렉션

Claude Code용 MCP 서버Claude Code 도구·스킬·플러그인오픈소스 AI 에이전트 프레임워크와 앱AI 코딩 어시스턴트와 에이전트MCP 서버

토픽

#mcp#gitlab#ai-agent#llm#code-review#devops#model-context-protocol#ai#claude#cursor

자주 묻는 질문

gitlab-mcp은(는) 무엇인가요?
AI 어시스턴트가 GitLab 프로젝트, 머지 리퀘스트, 이슈, 파이프라인, 위키 등을 다룰 수 있도록 구조화된 도구를 제공하는 MCP 서버입니다. gitlab-mcp는 Claude, Cursor, VS Code, Copilot 같은 AI 클라이언트를 GitLab 인스턴스에 연결하는 Model Context Protocol 서버입니다. GitLab REST 및 GraphQL API를 기반으로 프로젝트, 머지 리퀘스트, 이슈, 파이프라인, 위키, 릴리스, 태그, 마일스톤을 다루는 약 280개의 도구를 제공합니다. 기본적으로는 약 40개의 핵심 도구만 로드하고, 세션 중에 추가 도구 모음을 활성화할 수 있어 모델이 다루는 도구 목록을 간결하게 유지합니다.
gitlab-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
gitlab-mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
gitlab-mcp은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. gitlab-mcp의 마지막 커밋은 2026년 11월 5일입니다.
gitlab-mcp은(는) 어디에 사용할 수 있나요?
AI 코딩 어시스턴트에게 머지 리퀘스트의 변경 파일과 diff 검토 요청 에이전트가 GitLab 파이프라인 작업 로그를 확인하거나 CI 작업을 실행하도록 설정 사용자별 토큰을 사용해 팀에서 호스팅된 GitLab MCP 엔드포인트 하나를 공유 리포팅 또는 분류 작업을 위해 읽기 전용 GitLab 연동 운영
gitlab-mcp는 어떻게 설치하나요?
npm에서 바이너리를 설치합니다: npm install -g @zereight/mcp-gitlab GitLab 개인 액세스 토큰을 설정합니다(입력 내용은 화면에 표시되지 않습니다): read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN Claude Code에 서버를 등록합니다: claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab
gitlab-mcp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/zereight/gitlab-mcp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트