mcp-gitlab MCP 서버(영어)
fastmcp 프레임워크 기반으로 구축된 GitLab 통합 서버로, 다양한 GitLab RESTful API 도구를 제공합니다. Claude, Smithery 및 기타 플랫폼과의 통합을 지원합니다.
특징
GitlabSearchUserProjectsTool : 사용자 이름으로 사용자 및 활성 프로젝트 검색
GitlabGetUserTasksTool : 현재 사용자의 보류 중인 작업 가져오기
GitlabSearchProjectDetailsTool : 프로젝트 및 세부 정보 검색
GitlabCreateMRCommentTool : 병합 요청에 주석 추가
GitlabAcceptMRTool : 병합 요청 수락 및 병합
GitlabUpdateMRTool : 병합 요청 담당자, 검토자, 제목, 설명 및 레이블 업데이트
GitlabCreateMRTool : 담당자 및 검토자를 포함한 새 병합 요청 생성
GitlabRawApiTool : 사용자 정의 매개변수로 모든 GitLab API 호출
Related MCP server: gitlab-mcp-server
빠른 시작
지엑스피1
환경 변수
GITLAB_API_URL=https://your-gitlab-instance.com
GITLAB_TOKEN=your_access_token
# Optional: Provide a mapping from usernames to user IDs (JSON string)
# This can reduce API calls, especially when referencing the same users frequently
# Example: '{"username1": 123, "username2": 456}'
GITLAB_USER_MAPPING={"username1": 123, "username2": 456}
# Optional: Provide a mapping from project names to project IDs (JSON string)
# Project IDs can be numbers or strings (e.g., 'group/project')
# This can reduce API calls and ensure the correct project is used
# Example: '{"project-name-a": 1001, "group/project-b": "group/project-b"}'
GITLAB_PROJECT_MAPPING={"project-name-a": 1001, "group/project-b": "group/project-b"}사용 예
각 도구의 매개변수에 대한 자세한 예는 USAGE.md를 참조하세요.
프로젝트 구조
src/
├── server/
│ └── GitlabMCPServer.ts # MCP server entry point
├── tools/
│ ├── GitlabAcceptMRTool.ts
│ ├── GitlabCreateMRCommentTool.ts
│ ├── GitlabGetUserTasksTool.ts
│ ├── GitlabRawApiTool.ts
│ ├── GitlabSearchProjectDetailsTool.ts
│ ├── GitlabSearchUserProjectsTool.ts
│ └── gitlab/
│ ├── FieldFilterUtils.ts
│ ├── GitlabApiClient.ts
│ └── GitlabApiTypes.ts
├── utils/
│ ├── is.ts
│ └── sensitive.ts
smithery.json # Smithery config
USAGE.md # Usage examples
package.json
tsconfig.json완성
클로드 데스크톱 클라이언트
구성에 추가:
{
"mcpServers": {
"@zephyr-mcp/gitlab": {
"command": "npx",
"args": ["-y", "@zephyr-mcp/gitlab"]
}
}
}대장간
Smithery 플랫폼에서 직접 사용하세요:
smithery add @zephyr-mcp/gitlab또는 Smithery UI에서 "@zephyr-mcp/gitlab"을 검색하여 작업 공간에 추가하세요.
환경 변수:
GITLAB_API_URL: GitLab API의 기본 URLGITLAB_TOKEN: GitLab API 인증을 위한 액세스 토큰