GitLab MCP 서버

GitLab API를 위한 MCP 서버로, 프로젝트 관리, 파일 작업 등을 지원합니다.

특징

• 자동 브랜치 생성 : 파일을 생성/업데이트하거나 변경 사항을 푸시할 때 브랜치가 없으면 자동으로 생성됩니다.

• 포괄적인 오류 처리 : 일반적인 문제에 대한 명확한 오류 메시지

• Git 기록 보존 : 운영자는 강제 푸시 없이 적절한 Git 기록을 유지합니다.

• 일괄 작업 : 단일 파일 및 다중 파일 작업 모두 지원

도구

1. create_or_update_file

   • 프로젝트에서 단일 파일을 생성하거나 업데이트합니다.

   • 입력:

     • project_id (문자열): 프로젝트 ID 또는 URL로 인코딩된 경로

     • file_path (문자열): 파일을 생성/업데이트할 경로

     • content (문자열): 파일의 내용

     • commit_message (문자열): 커밋 메시지

     • branch (문자열): 파일을 생성/업데이트할 브랜치

     • previous_path (선택적 문자열): 이동/이름을 바꿀 파일의 경로

   • 반환: 파일 내용 및 커밋 세부 정보

2. push_files

   • 단일 커밋에 여러 파일 푸시

   • 입력:

     • project_id (문자열): 프로젝트 ID 또는 URL로 인코딩된 경로

     • branch (문자열): 푸시할 브랜치

     • files (배열): 푸시할 파일, 각각 file_path 와 content 있음

     • commit_message (문자열): 커밋 메시지

   • 반환: 업데이트된 지점 참조

3. search_repositories

   • GitLab 프로젝트 검색

   • 입력:

     • search (문자열): 검색어

     • page (선택적 숫자): 페이지 번호

     • per_page (선택적 숫자): 페이지당 결과(기본값 20)

   • 반환: 프로젝트 검색 결과

4. create_repository

   • 새로운 GitLab 프로젝트를 만듭니다

   • 입력:

     • name (문자열): 프로젝트 이름

     • description (선택 문자열): 프로젝트 설명

     • visibility (선택적 문자열): '비공개', '내부' 또는 '공개'

     • initialize_with_readme (선택적 부울): README로 초기화

   • 반환: 프로젝트 세부 정보 생성됨

5. get_file_contents

   • 파일이나 디렉토리의 내용을 가져옵니다

   • 입력:

     • project_id (문자열): 프로젝트 ID 또는 URL로 인코딩된 경로

     • file_path (문자열): 파일/디렉토리 경로

     • ref (선택적 문자열): 콘텐츠를 가져올 브랜치/태그/커밋

   • 반환: 파일/디렉토리 내용

6. create_issue

   • 새로운 이슈를 생성하세요

   • 입력:

     • project_id (문자열): 프로젝트 ID 또는 URL로 인코딩된 경로

     • title (문자열): 이슈 제목

     • description (선택 문자열): 문제 설명

     • assignee_ids (선택 사항 number[]): 할당할 사용자 ID

     • labels (선택적 문자열[]): 추가할 레이블

     • milestone_id (선택적 숫자): 마일스톤 ID

   • 반환: 문제 세부 정보 생성됨

7. create_merge_request

   • 새로운 병합 요청 만들기

   • 입력:

     • project_id (문자열): 프로젝트 ID 또는 URL로 인코딩된 경로

     • title (문자열): MR 제목

     • description (선택 문자열): MR 설명

     • source_branch (문자열): 변경 사항을 포함하는 브랜치

     • target_branch (문자열): 병합할 브랜치

     • draft (선택적 부울): 초안 MR로 생성

     • allow_collaboration (선택적 부울): 업스트림 멤버의 커밋 허용

   • 반환: 병합 요청 세부 정보가 생성되었습니다.

8. fork_repository

   • 프로젝트 포크하기

   • 입력:

     • project_id (문자열): 프로젝트 ID 또는 URL로 인코딩된 경로

     • namespace (선택적 문자열): 포크할 네임스페이스

   • 반환: 포크된 프로젝트 세부 정보

9. create_branch

   • 새로운 지점을 만드세요

   • 입력:

     • project_id (문자열): 프로젝트 ID 또는 URL로 인코딩된 경로

     • branch (문자열): 새 브랜치의 이름

     • ref (선택적 문자열): 새 브랜치에 대한 소스 브랜치/커밋

   • 반환: 생성된 브랜치 참조

Related MCP server: GitHub MCP Server Plus

설정

개인 액세스 토큰

적절한 권한을 가진 GitLab 개인 액세스 토큰을 생성하세요 .

• GitLab에서 사용자 설정 > 액세스 토큰으로 이동하세요.

• 필요한 범위를 선택하세요:

  • 전체 API 액세스를 위한 api

  • 읽기 전용 액세스를 위한 read_api

  • 저장소 작업을 위한 read_repository 및 write_repository

• 토큰을 생성하고 안전하게 저장하세요

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

도커

지엑스피1

엔피엑스

VS Code를 사용한 사용

빠른 설치를 위해 아래의 원클릭 설치 버튼 중 하나를 사용하세요...

수동 설치의 경우, VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.

원하는 경우, 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사용자와 구성을 공유할 수 있습니다.

.vscode/mcp.json 파일에는 mcp 키가 필요하지 않습니다.

도커

엔피엑스

짓다

Docker 빌드:

환경 변수

• GITLAB_PERSONAL_ACCESS_TOKEN : GitLab 개인 액세스 토큰(필수)

• GITLAB_API_URL : GitLab API의 기본 URL(선택 사항, 기본값은 https://gitlab.com/api/v4 )

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.