GitLab MCP 서버

GitLab 계정과 상호 작용할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 차이점 확인, 병합 요청 분석, 코드 검토, 변경 사항 선별 등의 작업을 수행할 수 있습니다. 이는 모델 컨텍스트 프로토콜 프로젝트의 MCP GitLab 서버 의 확장 버전입니다.

특징

이 MCP 서버는 다음을 포함하여 GitLab 저장소와 상호 작용하기 위한 포괄적인 도구를 제공합니다.

핵심 저장소 기능

프로젝트 목록 작성 및 세부 정보 검색
브랜치 및 저장소 관리
병합 요청 및 차이점 작업
병합 요청에 주석 및 내부 메모 추가
병합 요청 속성 업데이트
문제 나열 및 작업
저장소 파일 내용 가져오기 및 비교

프로젝트 설정 및 통합

프로젝트 통합 및 서비스 관리
Slack 통합 구성 및 제어
웹후크 설정, 업데이트 및 테스트

CI/CD 관리

파이프라인 트리거 토큰 작업
CI/CD 변수 관리
파이프라인 트리거링 및 제어

사용자 및 그룹 관리

사용자 목록 및 관리
그룹 및 그룹 멤버십 작업
프로젝트 멤버 및 액세스 수준 관리

설치

필수 조건

Node.js(v16 이상)
엔피엠
API 토큰이 있는 GitLab 계정

설정

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

git hooks 설치(선택 사항이지만 기여자에게 권장):

npm run install-hooks

이렇게 하면 src/utils/tools-data.ts가 변경될 때 TOOLS.md를 자동으로 다시 생성하는 사전 커밋 후크가 설치됩니다.

GitLab API 토큰을 구성하세요.

MCP 설정 구성 파일에 GitLab API 토큰을 입력해야 합니다. 이 토큰은 GitLab API 인증에 사용됩니다.

Cursor/Roo Cline의 경우 MCP 설정 파일( ~/Library/Application Support/Cursor/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json )에 다음을 추가합니다.

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": [
        "/path/to/mcp-gitlab/build/index.js"
      ],
      "env": {
        "GITLAB_API_TOKEN": "YOUR_GITLAB_API_TOKEN",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

Claude Desktop의 경우 MCP 설정 파일( ~/Library/Application Support/Claude/claude_desktop_config.json )에 다음을 추가합니다.

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": [
        "/path/to/mcp-gitlab/build/index.js"
      ],
      "env": {
        "GITLAB_API_TOKEN": "YOUR_GITLAB_API_TOKEN",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

YOUR_GITLAB_API_TOKEN 실제 GitLab API 토큰으로 바꾸세요. GitLab 계정의 설정 > 액세스 토큰에서 토큰을 생성할 수 있습니다.

사용 가능한 도구

사용 가능한 도구와 매개변수의 전체 목록을 보려면 TOOLS.md를 참조하세요.

사용 예

MCP를 지원하는 AI 어시스턴트와 함께 이러한 도구를 사용하는 방법에 대한 예는 다음과 같습니다.

프로젝트를 나열하세요

Could you list my GitLab projects?

특정 병합 요청에 대한 정보 가져오기

Can you show me the details of merge request with ID 123 in the project 'mygroup/myproject'?

병합 요청에 주석 추가

Please add a comment to merge request 123 in project 'mygroup/myproject' saying "This looks good, but please add more tests."

병합 요청에 내부 메모 추가

Add an internal note to merge request 123 in project 'mygroup/myproject' that says "Needs security review before merging." Make sure it's only visible to team members.

병합 요청 제목 및 설명 업데이트

Update the title of merge request 123 in project 'mygroup/myproject' to "Fix login page performance issues" and update the description to include "This PR addresses the slow loading times on the login page by optimizing database queries."

지점 비교

Compare the 'feature-branch' with 'main' in the project 'mygroup/myproject' and show me the differences.

실용적인 워크플로

병합 요청 검토

Show me merge request 123 in project 'mygroup/myproject'
Show me the changes for this merge request
Add an internal note with my review comments
Update the merge request title to better reflect the changes

프로젝트 탐색

List all my GitLab projects
Show me the details of project 'mygroup/myproject'
List all branches in this project
Show me the content of the README.md file in the main branch

사용 가능한 리소스

gitlab://프로젝트

API 토큰으로 접근할 수 있는 GitLab 프로젝트 목록입니다.

AI 어시스턴트와의 통합

GitLab MCP 서버는 MCP(모델 컨텍스트 프로토콜)를 지원하는 AI 어시스턴트와 통합됩니다.

역량

이 서버가 AI 어시스턴트에 연결되면 어시스턴트는 다음을 수행할 수 있습니다.

코드 보기 및 분석 : 도우미는 파일 내용을 가져오고, 브랜치 차이점을 보고, 병합 요청 변경 사항을 조사하여 코드를 더 잘 이해할 수 있습니다.
코드 검토 제공 : 보조 기능은 병합 요청을 분석하고 주석이나 내부 메모를 통해 피드백을 제공할 수 있습니다.
프로젝트 워크플로 관리 : 보조자는 병합 요청 속성을 업데이트하고, 주석을 추가하고, 저장소 관리 작업을 도울 수 있습니다.
프로젝트 구조 탐색 : 보조자는 프로젝트, 브랜치, 파일을 탐색하여 코드베이스 구조를 이해할 수 있습니다.
CI/CD 및 통합 구성 : 어시스턴트는 웹후크 설정, CI/CD 변수 관리, 프로젝트 통합 구성을 도울 수 있습니다.

AI Assistant 통합을 최대한 활용하기

프로젝트, 병합 요청 또는 파일에 대해 질문할 때는 구체적으로 설명하세요.
가능하면 프로젝트 ID 또는 경로를 제공하세요.
특정 병합 요청을 분석하도록 요청하여 코드 검토를 위한 도우미를 활용하세요.
보조자에게 저장소 구성 및 관리 작업을 도와달라고 요청하세요.
병합 요청에 대한 팀 전용 피드백을 위해 내부 메모를 사용하세요.

특허

MIT

GitLab MCP Server

Integrations