@zereight/mcp-gitlab 2.3.16 → 2.3.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.ko.md +6 -6
- package/README.md +96 -87
- package/README.pt-BR.md +6 -6
- package/README.zh-CN.md +6 -6
- package/package.json +1 -1
package/LICENSE
CHANGED
package/README.ko.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
📖 **[문서 →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
|
|
8
8
|
|
|
9
|
-
**기본 노출: 40개 도구** (`core` 38개 + `discover_tools` + `help`). 전체는
|
|
9
|
+
**기본 노출: 40개 도구** (`core` 38개 + `discover_tools` + `help`). 전체는 287개(toolset 284개 + `execute_graphql` + `discover_tools` + `help`). 작게 시작하고, 세션에서 `discover_tools`로 확장하세요.
|
|
10
10
|
|
|
11
11
|
`zereight-mcp-gitlab` 바이너리를 먼저 설치하세요. `npm install -g @zereight/mcp-gitlab`, 또는 Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` 다음 `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. 공식 MCP Registry 항목: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). 한 줄 설치: `npx -y @zereight/mcp-gitlab@latest`.
|
|
12
12
|
|
|
@@ -138,7 +138,7 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
|
|
|
138
138
|
|
|
139
139
|
### 왜 이 GitLab MCP를 사용하나요?
|
|
140
140
|
|
|
141
|
-
- **기본 40개 도구(`core` 38 + `discover_tools` + `help`); 전체
|
|
141
|
+
- **기본 40개 도구(`core` 38 + `discover_tools` + `help`); 전체 287개** — 작게 시작하고, `discover_tools`로 세션에서 확장
|
|
142
142
|
- **MR 2단계 리뷰** — `list_merge_request_changed_files` → 배치 `get_merge_request_file_diff`
|
|
143
143
|
- **Agent Skill 내장** — `skills/gitlab-mcp/` 워크플로우 가이드
|
|
144
144
|
- **유연한 인증** — Personal Access Token, 로컬 OAuth2 브라우저 플로우, MCP OAuth 프록시, 요청별 원격 인증
|
|
@@ -152,7 +152,7 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
|
|
|
152
152
|
| | @zereight/mcp-gitlab | GitLab MCP A (커뮤니티 CQRS형) | GitLab 공식 MCP 서버 |
|
|
153
153
|
| --------------- | ---------------------------------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
154
154
|
| **적합한 경우** | AI 에이전트 워크플로우 | 엔터프라이즈 멀티 인스턴스 / 그룹형 도구 | GitLab에 내장, 별도 설치 없음 |
|
|
155
|
-
| **도구 모델** |
|
|
155
|
+
| **도구 모델** | 287개 도구: toolset 284개 + `execute_graphql` + `discover_tools` + `help` | ~50–60개 `browse_*` / `manage_*` 그룹 도구 | HTTP 헤더로 고르는 toolset |
|
|
156
156
|
| **MR 리뷰** | 2단계 배치 diff | 서버마다 다름 | `get_merge_request`에 diffs |
|
|
157
157
|
| **Node.js** | >=20.0.0 | 보통 >=24 | stdio는 `mcp-remote`, Node.js 20+ |
|
|
158
158
|
| **라이선스** | MIT | 서버마다 다름 | GitLab의 일부 |
|
|
@@ -252,7 +252,7 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
|
|
|
252
252
|
|
|
253
253
|
예시는 기존 `mcp-gitlab`보다 충돌 가능성이 낮은 `zereight-mcp-gitlab` 별칭을 사용합니다. MCP 클라이언트가 찾지 못하면 `which zereight-mcp-gitlab`의 절대 경로를 사용하세요.
|
|
254
254
|
|
|
255
|
-
전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.3.
|
|
255
|
+
전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.3.16`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. `main`에 머지된 수정을 다음 안정 버전 전에 확인하려면 프리릴리스 빌드인 `npx -y @zereight/mcp-gitlab@next`를 사용하세요(운영 환경용이 아닙니다). 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
|
|
256
256
|
|
|
257
257
|
#### Claude Desktop 원클릭 설치(MCP Bundle)
|
|
258
258
|
|
|
@@ -616,7 +616,7 @@ Private-Token: glpat-xxxxxxxxxxxxxxxxxxxx
|
|
|
616
616
|
- 각 세션은 격리됩니다. 한 세션의 토큰은 다른 세션 데이터에 접근할 수 없습니다. 세션이 종료되면 토큰은 자동으로 정리됩니다.
|
|
617
617
|
- **세션 타임아웃:** 인증 토큰은 `SESSION_TIMEOUT_SECONDS`(기본 1시간) 동안 비활성 상태가 지속되면 만료됩니다. 만료 후 클라이언트는 인증 헤더를 다시 보내야 합니다. 전송 세션은 유지됩니다.
|
|
618
618
|
- 각 요청은 해당 세션의 타임아웃 타이머를 초기화합니다.
|
|
619
|
-
- **Rate limiting:** `/mcp` 요청은 클라이언트 IP당 `MAX_REQUESTS_PER_MINUTE`로 제한되며, OAuth 또는 원격 인증 사용 시 MCP 세션당으로도 제한됩니다(기본 60). 자세한 내용은 [environment-variables.md](docs/configuration/environment-variables.md#max_requests_per_minute)를 참고하세요.
|
|
619
|
+
- **Rate limiting:** `/mcp` 요청은 클라이언트 IP당 `MAX_REQUESTS_PER_MINUTE`로 제한되며, OAuth 또는 원격 인증 사용 시 MCP 세션당으로도 제한됩니다(기본 60). IP당 한도는 고정 60초 윈도우를 사용하고 서버 프로세스별로 집계되며 `GET /mcp`에도 적용됩니다. stateless 모드에서는 세션당 한도를 건너뜁니다. 자세한 내용은 [environment-variables.md](docs/configuration/environment-variables.md#max_requests_per_minute)를 참고하세요.
|
|
620
620
|
- **Capacity limit:** 서버는 최대 `MAX_SESSIONS` 동시 세션을 허용합니다(기본 1000).
|
|
621
621
|
|
|
622
622
|
### MCP OAuth 설정(Claude.ai Native OAuth)
|
|
@@ -692,7 +692,7 @@ node build/index.js
|
|
|
692
692
|
| `GITLAB_API_URL` | 예 | GitLab 인스턴스 API URL(예: `https://gitlab.com/api/v4`). URL에 자격 증명(`user:pass@`)을 넣지 마세요. 넣어도 무시됩니다. 비밀번호의 쉼표는 반드시 `%2C`로 적어야 합니다. |
|
|
693
693
|
| `STREAMABLE_HTTP` | 예 | 반드시 `true`(SSE 미지원) |
|
|
694
694
|
| `GITLAB_OAUTH_SCOPES` | 아니오 | 요청할 GitLab scope 목록(쉼표 구분). 기본값은 `api`이며, 유효 permission mode가 `readonly`일 때 `read_api`입니다. 사전 등록 애플리케이션에 해당 scope가 설정되어 있어야 합니다. |
|
|
695
|
-
| `OAUTH_REGISTER_RATE_LIMIT_PER_HOUR` | 아니오 | Dynamic Client Registration(`POST /register`)의 클라이언트 IP당
|
|
695
|
+
| `OAUTH_REGISTER_RATE_LIMIT_PER_HOUR` | 아니오 | Dynamic Client Registration(`POST /register`)의 클라이언트 IP당 한도(고정 1시간 윈도우). 기본 `20`/시간, 범위 `1`–`1000`. IDE 창 여러 개 등으로 등록이 막히면 올리세요. GitLab API 한도와 무관합니다. |
|
|
696
696
|
| `OAUTH_DISABLE_REFRESH_TOKEN` | 아니오 | `true`면 `/token` 응답에서 `refresh_token`을 빼고 refresh grant를 `invalid_grant`로 거부합니다. GitLab access token이 만료되면 브라우저에서 다시 인가해야 합니다. 기본 `false`. 콜백 프록시 모드에서는 이 서버의 흐름을 따르는 MCP 클라이언트가 GitLab refresh token을 받지 못합니다(passthrough에서는 클라이언트가 GitLab에서 직접 받을 수 있음). 표준 MCP 클라이언트를 위한 재인가 정책이며 보안 경계가 아닙니다. 켜기 전에 발급된 refresh token은 GitLab **User Settings → Applications → Authorized applications → Revoke**로 revoke할 때까지 유효합니다. |
|
|
697
697
|
| `MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL` | 아니오 | 로컬 HTTP 개발에서만 `true` |
|
|
698
698
|
|
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
📖 **[Documentation →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
|
|
14
14
|
|
|
15
|
-
**Default: 40 tools** (38 `core` + `discover_tools` + `help`).
|
|
15
|
+
**Default: 40 tools** (38 `core` + `discover_tools` + `help`). 287 tools exist in total (284 in toolsets + `execute_graphql` + `discover_tools` + `help`). Start lean; call `discover_tools` to activate more for this session.
|
|
16
16
|
|
|
17
17
|
Install the `zereight-mcp-gitlab` binary first with `npm install -g @zereight/mcp-gitlab`, or Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` and `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. Official MCP Registry listing: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). One-liner: `npx -y @zereight/mcp-gitlab@latest`.
|
|
18
18
|
|
|
@@ -144,7 +144,7 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
|
|
|
144
144
|
|
|
145
145
|
### Why use this GitLab MCP?
|
|
146
146
|
|
|
147
|
-
- **Default 40 tools (38 `core` + `discover_tools` + `help`);
|
|
147
|
+
- **Default 40 tools (38 `core` + `discover_tools` + `help`); 287 total** — start lean; call `discover_tools` to activate more without CQRS-style grouping
|
|
148
148
|
- **MR 2-step review** — `list_merge_request_changed_files` → batched `get_merge_request_file_diff`
|
|
149
149
|
- **Agent Skill built in** — workflow guidance in `skills/gitlab-mcp/`
|
|
150
150
|
- **Flexible auth** — Personal Access Token, local OAuth2 browser flow, MCP OAuth proxy, and per-request remote authorization
|
|
@@ -158,7 +158,7 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
|
|
|
158
158
|
| | @zereight/mcp-gitlab | GitLab MCP A (community CQRS-style) | GitLab official MCP server |
|
|
159
159
|
| -------------- | ----------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
160
160
|
| **Best for** | AI agent workflows | Enterprise multi-instance / grouped tools | Built into GitLab, no separate install |
|
|
161
|
-
| **Tool model** |
|
|
161
|
+
| **Tool model** | 287 tools: 284 in toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 grouped `browse_*` / `manage_*` tools | Toolsets chosen with an HTTP header |
|
|
162
162
|
| **MR review** | 2-step batched diff | Varies | `get_merge_request` with diffs |
|
|
163
163
|
| **Node.js** | >=20.0.0 | Often >=24 | Node.js 20+ for stdio via `mcp-remote` |
|
|
164
164
|
| **License** | MIT | Varies | Part of GitLab |
|
|
@@ -258,7 +258,7 @@ The store path is pinned by your lock file; update it with `nix flake update git
|
|
|
258
258
|
|
|
259
259
|
The examples use `zereight-mcp-gitlab`, a less collision-prone alias for the legacy `mcp-gitlab` binary. If your MCP client cannot find it, use the absolute path from `which zereight-mcp-gitlab`.
|
|
260
260
|
|
|
261
|
-
No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.
|
|
261
|
+
No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.16`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. To try a fix merged to `main` before the next stable release, use `npx -y @zereight/mcp-gitlab@next`, a pre-release build that is not meant for production. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
|
|
262
262
|
|
|
263
263
|
#### Claude Desktop one-click install (MCP Bundle)
|
|
264
264
|
|
|
@@ -655,7 +655,7 @@ The token is stored per session (identified by `mcp-session-id` header) and reus
|
|
|
655
655
|
Tokens are automatically cleaned up when sessions close
|
|
656
656
|
- **Session timeout:** Auth tokens expire after `SESSION_TIMEOUT_SECONDS` (default 1 hour) of inactivity. After timeout, the client must send auth headers again. The transport session remains active.
|
|
657
657
|
- Each request resets the timeout timer for that session
|
|
658
|
-
- **Rate limiting:** `/mcp` requests are limited to `MAX_REQUESTS_PER_MINUTE` per client IP, and per MCP session when using OAuth or remote authorization (default 60). See [environment-variables.md](docs/configuration/environment-variables.md#max_requests_per_minute).
|
|
658
|
+
- **Rate limiting:** `/mcp` requests are limited to `MAX_REQUESTS_PER_MINUTE` per client IP, and per MCP session when using OAuth or remote authorization (default 60). The per-IP limit uses a fixed 60-second window, counts per server process, and also covers `GET /mcp`; stateless mode skips the per-session limit. See [environment-variables.md](docs/configuration/environment-variables.md#max_requests_per_minute).
|
|
659
659
|
- **Capacity limit:** Server accepts up to `MAX_SESSIONS` concurrent sessions (default 1000)
|
|
660
660
|
|
|
661
661
|
### MCP OAuth Setup (Claude.ai Native OAuth)
|
|
@@ -735,7 +735,7 @@ No `headers` field is needed — Claude.ai obtains the token via OAuth automatic
|
|
|
735
735
|
| `GITLAB_API_URL` | Yes | Your GitLab instance API URL (e.g. `https://gitlab.com/api/v4`). Do not embed credentials (`user:pass@`) in the URL; they are ignored. A comma in a password must be written as `%2C`. |
|
|
736
736
|
| `STREAMABLE_HTTP` | Yes | Must be `true` (SSE is not supported) |
|
|
737
737
|
| `GITLAB_OAUTH_SCOPES` | No | Comma-separated GitLab scopes to request (e.g. `api,read_user`). Defaults to `api` (or `read_api` when the effective permission mode is `readonly`). The pre-registered application must be configured with at least these scopes. |
|
|
738
|
-
| `OAUTH_REGISTER_RATE_LIMIT_PER_HOUR` | No | Per-IP
|
|
738
|
+
| `OAUTH_REGISTER_RATE_LIMIT_PER_HOUR` | No | Per-IP limit (fixed 1-hour window) for Dynamic Client Registration (`POST /register`). Default `20`/hour; range `1`–`1000`. Raise when clients (e.g. multiple IDE windows) hit registration throttling. Not a GitLab API limit. |
|
|
739
739
|
| `OAUTH_DISABLE_REFRESH_TOKEN` | No | Set `true` to drop `refresh_token` from `/token` responses and reject the refresh grant with `invalid_grant`, so users re-authorize in the browser when the GitLab access token expires. Default `false`. In callback proxy mode, MCP clients that follow this server's flow never receive a GitLab refresh token (in passthrough the client can get one from GitLab directly). This is a re-authorization policy for standard MCP clients, not a security boundary. Refresh tokens issued before enabling stay valid until revoked in GitLab under **User Settings → Applications → Authorized applications → Revoke**. |
|
|
740
740
|
| `MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL` | No | Set `true` for local HTTP dev only |
|
|
741
741
|
|
|
@@ -974,87 +974,96 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
|
|
|
974
974
|
195. `list_commit_statuses` - List statuses for a commit
|
|
975
975
|
196. `create_commit_status` - Create or update the status of a commit
|
|
976
976
|
197. `list_group_iterations` - List group iterations with filtering options
|
|
977
|
-
198. `
|
|
978
|
-
199. `
|
|
979
|
-
200. `
|
|
980
|
-
201. `
|
|
981
|
-
202. `
|
|
982
|
-
203. `
|
|
983
|
-
204. `
|
|
984
|
-
205. `
|
|
985
|
-
206. `
|
|
986
|
-
207. `
|
|
987
|
-
208. `
|
|
988
|
-
209. `
|
|
989
|
-
210. `
|
|
990
|
-
211. `
|
|
991
|
-
212. `
|
|
992
|
-
213. `
|
|
993
|
-
214. `
|
|
994
|
-
215. `
|
|
995
|
-
216. `
|
|
996
|
-
217. `
|
|
997
|
-
218. `
|
|
998
|
-
219. `
|
|
999
|
-
220. `
|
|
1000
|
-
221. `
|
|
1001
|
-
222. `
|
|
1002
|
-
223. `
|
|
1003
|
-
224. `
|
|
1004
|
-
225. `
|
|
1005
|
-
226. `
|
|
1006
|
-
227. `
|
|
1007
|
-
228. `
|
|
1008
|
-
229. `
|
|
1009
|
-
230. `
|
|
1010
|
-
231. `
|
|
1011
|
-
232. `
|
|
1012
|
-
233. `
|
|
1013
|
-
234. `
|
|
1014
|
-
235. `
|
|
1015
|
-
236. `
|
|
1016
|
-
237. `
|
|
1017
|
-
238. `
|
|
1018
|
-
239. `
|
|
1019
|
-
240. `
|
|
1020
|
-
241. `
|
|
1021
|
-
242. `
|
|
1022
|
-
243. `
|
|
1023
|
-
244. `
|
|
1024
|
-
245. `
|
|
1025
|
-
246. `
|
|
1026
|
-
247. `
|
|
1027
|
-
248. `
|
|
1028
|
-
249. `
|
|
1029
|
-
250. `
|
|
1030
|
-
251. `
|
|
1031
|
-
252. `
|
|
1032
|
-
253. `
|
|
1033
|
-
254. `
|
|
1034
|
-
255. `
|
|
1035
|
-
256. `
|
|
1036
|
-
257. `
|
|
1037
|
-
258. `
|
|
1038
|
-
259. `
|
|
1039
|
-
260. `
|
|
1040
|
-
261. `
|
|
1041
|
-
262. `
|
|
1042
|
-
263. `
|
|
1043
|
-
264. `
|
|
1044
|
-
265. `
|
|
1045
|
-
266. `
|
|
1046
|
-
267. `
|
|
1047
|
-
268. `
|
|
1048
|
-
269. `
|
|
1049
|
-
270. `
|
|
1050
|
-
271. `
|
|
1051
|
-
272. `
|
|
1052
|
-
273. `
|
|
1053
|
-
274. `
|
|
1054
|
-
275. `
|
|
1055
|
-
276. `
|
|
1056
|
-
277. `
|
|
1057
|
-
278. `
|
|
977
|
+
198. `get_group_iteration` - Get a group iteration by ID, IID, or GraphQL GID
|
|
978
|
+
199. `update_group_iteration` - Update a manual group iteration's title, description, or dates
|
|
979
|
+
200. `create_group_iteration` - Create a group iteration, optionally in a given iteration cadence
|
|
980
|
+
201. `delete_group_iteration` - Delete a group iteration by ID, IID, or GraphQL GID
|
|
981
|
+
202. `list_project_iterations` - List the iterations available to a project with filtering options
|
|
982
|
+
203. `list_group_iteration_cadences` - List a group's iteration cadences with filtering options
|
|
983
|
+
204. `create_group_iteration_cadence` - Create an iteration cadence in a group
|
|
984
|
+
205. `update_group_iteration_cadence` - Update an iteration cadence's title, description, schedule, or automation
|
|
985
|
+
206. `delete_group_iteration_cadence` - Delete an iteration cadence
|
|
986
|
+
207. `upload_markdown` - Upload a file for use in markdown content
|
|
987
|
+
208. `download_attachment` - Download an uploaded file from a project (images returned as base64; other files, or images with local_path, are saved as new files under the download directory)
|
|
988
|
+
209. `health_check` - Verify server status and authentication. Always reports the MCP server version (mcp_server_version). When authenticated, also reports the GitLab instance version from GET /api/v4/version (version, revision, enterprise). Version lookup failures do not fail the health check — those fields are omitted.
|
|
989
|
+
210. `list_events` - List events for the authenticated user (before/after: YYYY-MM-DD)
|
|
990
|
+
211. `get_project_events` - List events for a project (before/after: YYYY-MM-DD)
|
|
991
|
+
212. `list_releases` - List all releases for a project
|
|
992
|
+
213. `get_release` - Get a release by tag name
|
|
993
|
+
214. `create_release` - Create a new release
|
|
994
|
+
215. `update_release` - Update an existing release
|
|
995
|
+
216. `delete_release` - Delete a release (does not delete the tag)
|
|
996
|
+
217. `create_release_evidence` - Create release evidence (Premium/Ultimate)
|
|
997
|
+
218. `download_release_asset` - Download a release asset file by direct asset path
|
|
998
|
+
219. `list_tags` - List repository tags for a project
|
|
999
|
+
220. `get_tag` - Get a repository tag by name
|
|
1000
|
+
221. `create_tag` - Create a new repository tag
|
|
1001
|
+
222. `delete_tag` - Delete a repository tag
|
|
1002
|
+
223. `get_tag_signature` - Get the X.509 signature of a signed tag (404 if unsigned)
|
|
1003
|
+
224. `list_protected_tags` - List protected tags in a project
|
|
1004
|
+
225. `get_protected_tag` - Get details of a single protected tag or wildcard (create access levels)
|
|
1005
|
+
226. `protect_tag` - Protect a repository tag or wildcard (set who can create it)
|
|
1006
|
+
227. `unprotect_tag` - Remove protection from a previously protected tag or wildcard
|
|
1007
|
+
228. `get_work_item` - Get a work item with full details including status, hierarchy, type, and widgets
|
|
1008
|
+
229. `list_work_items` - List work items with filters (type, state, search, assignees, labels)
|
|
1009
|
+
230. `create_work_item` - Create a work item (issue, task, incident, epic, etc.) with full field support
|
|
1010
|
+
231. `update_work_item` - Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)
|
|
1011
|
+
232. `convert_work_item_type` - Convert a work item to a different type
|
|
1012
|
+
233. `list_work_item_statuses` - List available statuses for a work item type (Premium/Ultimate)
|
|
1013
|
+
234. `list_custom_field_definitions` - List custom field definitions for a work item type
|
|
1014
|
+
235. `move_work_item` - Move a work item to a different project
|
|
1015
|
+
236. `list_work_item_notes` - List notes and discussions on a work item
|
|
1016
|
+
237. `create_work_item_note` - Add a note to a work item (supports Markdown, internal notes, threads)
|
|
1017
|
+
238. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
|
|
1018
|
+
239. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
|
|
1019
|
+
240. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
|
|
1020
|
+
241. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
|
|
1021
|
+
242. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
|
|
1022
|
+
243. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
|
|
1023
|
+
244. `get_timeline_events` - List timeline events for an incident
|
|
1024
|
+
245. `create_timeline_event` - Create a timeline event on an incident
|
|
1025
|
+
246. `list_webhooks` - List webhooks for a project or group
|
|
1026
|
+
247. `create_webhook` - Create a webhook on a project or group
|
|
1027
|
+
248. `update_webhook` - Update an existing project or group webhook
|
|
1028
|
+
249. `delete_webhook` - Delete a project or group webhook
|
|
1029
|
+
250. `list_webhook_events` - List recent webhook events (past 7 days)
|
|
1030
|
+
251. `get_webhook_event` - Get full details of a specific webhook event
|
|
1031
|
+
252. `search_code` - Search for code across all projects (requires advanced search or Zoekt)
|
|
1032
|
+
253. `search_project_code` - Search for code within a specific project (requires advanced search or Zoekt)
|
|
1033
|
+
254. `search_group_code` - Search for code within a specific group (requires advanced search or Zoekt)
|
|
1034
|
+
255. `list_project_variables` - List CI/CD variables for a project
|
|
1035
|
+
256. `get_project_variable` - Get a single CI/CD variable from a project
|
|
1036
|
+
257. `create_project_variable` - Create a CI/CD variable for a project
|
|
1037
|
+
258. `update_project_variable` - Update an existing CI/CD variable in a project
|
|
1038
|
+
259. `delete_project_variable` - Delete a CI/CD variable from a project
|
|
1039
|
+
260. `list_group_variables` - List CI/CD variables for a group
|
|
1040
|
+
261. `get_group_variable` - Get a single CI/CD variable from a group
|
|
1041
|
+
262. `create_group_variable` - Create a CI/CD variable for a group
|
|
1042
|
+
263. `update_group_variable` - Update an existing CI/CD variable in a group
|
|
1043
|
+
264. `delete_group_variable` - Delete a CI/CD variable from a group
|
|
1044
|
+
265. `get_dependency_proxy_settings` - Get dependency proxy settings for a group
|
|
1045
|
+
266. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
|
|
1046
|
+
267. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group
|
|
1047
|
+
268. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
|
|
1048
|
+
269. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
|
|
1049
|
+
270. `get_vulnerability` - Get full details of a specific vulnerability
|
|
1050
|
+
271. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
|
|
1051
|
+
272. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
|
|
1052
|
+
273. `orbit_query` - Execute a GitLab Orbit graph query over the indexed SDLC knowledge graph
|
|
1053
|
+
274. `orbit_get_schema` - Fetch the current GitLab Orbit graph schema (node and edge types)
|
|
1054
|
+
275. `orbit_get_status` - Check GitLab Orbit indexing status for the enabled scope
|
|
1055
|
+
276. `orbit_list_tools` - List the MCP tool definitions exposed by GitLab Orbit
|
|
1056
|
+
277. `list_snippets` - List snippets — project snippets when project_id is given, otherwise personal snippets
|
|
1057
|
+
278. `get_snippet` - Get a snippet's metadata. Set include_content=true to also fetch the raw file content.
|
|
1058
|
+
279. `create_snippet` - Create a snippet — project-scoped when project_id is given, otherwise a personal snippet. Requires title plus either file_name + content (single file) or files[] (multi-file); the two shapes cannot be mixed.
|
|
1059
|
+
280. `update_snippet` - Update an existing snippet (provide at least one field to change). For multi-file edits — renames, deletions, additions — pass files[] with action (create/update/delete/move) and previous_path. The file_name + content shortcut still works for single-file content replacement.
|
|
1060
|
+
281. `delete_snippet` - Delete a snippet
|
|
1061
|
+
282. `list_project_runners` - List runners available to a project (type, status, paused, tag_list). Omits registration and authentication tokens.
|
|
1062
|
+
283. `get_runner` - Get a runner's tag_list, run_untagged, locked, and access_level. When a project allowlist is active, the runner must be available to an allowed project. Omits registration and authentication tokens.
|
|
1063
|
+
284. `rebase_merge_request` - Rebase the source branch of a merge request onto its target branch
|
|
1064
|
+
285. `gitlab_api_request` - Send one GitLab REST call under /api/v4. Enabled only when GITLAB_TOOLSETS lists api. Readonly allows GET; modify rejects DELETE.
|
|
1065
|
+
286. `discover_tools` - Discover and activate additional tool categories for this session. Available categories: core, merge_requests, issues, repositories, branches, projects, labels, ci, groups, pipelines, milestones, wiki, releases, tags, snippets, users, workitems, webhooks, search, variables, dependency_proxy, vulnerabilities, orbit. Already-active categories are listed in the response.
|
|
1066
|
+
287. `help` - Return a short GitLab workflow guide. Omit topic for the overview and topic list.
|
|
1058
1067
|
|
|
1059
1068
|
<!-- TOOLS-END -->
|
|
1060
1069
|
|
package/README.pt-BR.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
📖 **[Documentação →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
|
|
8
8
|
|
|
9
|
-
**Padrão: 40 ferramentas** (38 `core` + `discover_tools` + `help`). Existem
|
|
9
|
+
**Padrão: 40 ferramentas** (38 `core` + `discover_tools` + `help`). Existem 287 no total (284 em toolsets + `execute_graphql` + `discover_tools` + `help`). Comece enxuto; chame `discover_tools` para ativar mais nesta sessão.
|
|
10
10
|
|
|
11
11
|
Instale o binário `zereight-mcp-gitlab` antes. `npm install -g @zereight/mcp-gitlab`, ou Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` e `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. Listagem oficial no MCP Registry: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). Instalação em uma linha: `npx -y @zereight/mcp-gitlab@latest`.
|
|
12
12
|
|
|
@@ -138,7 +138,7 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinâmicas e autorização
|
|
|
138
138
|
|
|
139
139
|
### Por que usar este GitLab MCP?
|
|
140
140
|
|
|
141
|
-
- **40 ferramentas por padrão (38 `core` + `discover_tools` + `help`);
|
|
141
|
+
- **40 ferramentas por padrão (38 `core` + `discover_tools` + `help`); 287 no total** — comece enxuto; chame `discover_tools` para expandir nesta sessão
|
|
142
142
|
- **Revisão de MR em 2 etapas** — `list_merge_request_changed_files` → `get_merge_request_file_diff` em lote
|
|
143
143
|
- **Agent Skill integrado** — orientação de workflows em `skills/gitlab-mcp/`
|
|
144
144
|
- **Autenticação flexível** — Personal Access Token, fluxo OAuth2 local no navegador, proxy MCP OAuth e autorização remota por requisição
|
|
@@ -152,7 +152,7 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinâmicas e autorização
|
|
|
152
152
|
| | @zereight/mcp-gitlab | GitLab MCP A (comunidade, estilo CQRS) | Servidor MCP oficial do GitLab |
|
|
153
153
|
| ------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
154
154
|
| **Mais indicado para** | Workflows de agentes de IA | Múltiplas instâncias corporativas / ferramentas agrupadas | Integrado ao GitLab, sem instalação separada |
|
|
155
|
-
| **Modelo de ferramentas** |
|
|
155
|
+
| **Modelo de ferramentas** | 287 ferramentas: 284 em toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 ferramentas agrupadas `browse_*` / `manage_*` | Toolsets escolhidos por cabeçalho HTTP |
|
|
156
156
|
| **Revisão de MR** | Diff em lote em 2 etapas | Varia | `get_merge_request` com diffs |
|
|
157
157
|
| **Node.js** | >=20.0.0 | Frequentemente >=24 | Node.js 20+ para stdio via `mcp-remote` |
|
|
158
158
|
| **Licença** | MIT | Varia | Parte do GitLab |
|
|
@@ -252,7 +252,7 @@ O caminho no store é fixado pelo seu lock file; atualize-o com `nix flake updat
|
|
|
252
252
|
|
|
253
253
|
Os exemplos usam `zereight-mcp-gitlab`, um alias com menor chance de conflito que o binário legado `mcp-gitlab`. Se o seu cliente MCP não o encontrar, use o caminho absoluto retornado por `which zereight-mcp-gitlab`.
|
|
254
254
|
|
|
255
|
-
Não quer instalar globalmente? Fixe o `npx` na versão estável anterior (a versão recomendada por esta documentação), por exemplo `npx -y @zereight/mcp-gitlab@2.3.
|
|
255
|
+
Não quer instalar globalmente? Fixe o `npx` na versão estável anterior (a versão recomendada por esta documentação), por exemplo `npx -y @zereight/mcp-gitlab@2.3.16`. Se quiser sempre a versão mais recente, use `npx -y @zereight/mcp-gitlab@latest`. Para testar uma correção já mesclada na `main` antes da próxima versão estável, use `npx -y @zereight/mcp-gitlab@next`, um build de pré-lançamento que não é indicado para produção. O servidor exibe um aviso no stderr durante a inicialização quando existe uma versão mais nova disponível (desative com `GITLAB_DISABLE_VERSION_CHECK=true`).
|
|
256
256
|
|
|
257
257
|
#### Instalação com um clique no Claude Desktop (MCP Bundle)
|
|
258
258
|
|
|
@@ -616,7 +616,7 @@ O token é armazenado por sessão (identificada pelo header `mcp-session-id`) e
|
|
|
616
616
|
- Cada sessão é isolada. O token de uma sessão não pode acessar os dados de outra sessão. Os tokens são limpos automaticamente quando a sessão é encerrada.
|
|
617
617
|
- **Timeout de sessão:** os tokens de autenticação expiram após `SESSION_TIMEOUT_SECONDS` (padrão 1 hora) sem atividade. Após o timeout, o cliente precisa enviar novamente os headers de autenticação. A sessão de transporte permanece ativa.
|
|
618
618
|
- Cada requisição reinicia o timer de timeout da sessão.
|
|
619
|
-
- **Rate limiting:** requisições a `/mcp` são limitadas por IP do cliente a `MAX_REQUESTS_PER_MINUTE`; ao usar OAuth ou autorização remota, também são limitadas por sessão MCP (padrão 60). Veja [environment-variables.md](docs/configuration/environment-variables.md#max_requests_per_minute).
|
|
619
|
+
- **Rate limiting:** requisições a `/mcp` são limitadas por IP do cliente a `MAX_REQUESTS_PER_MINUTE`; ao usar OAuth ou autorização remota, também são limitadas por sessão MCP (padrão 60). O limite por IP usa uma janela fixa de 60 segundos, conta por processo do servidor e também cobre `GET /mcp`; o modo stateless ignora o limite por sessão. Veja [environment-variables.md](docs/configuration/environment-variables.md#max_requests_per_minute).
|
|
620
620
|
- **Limite de capacidade:** o servidor aceita no máximo `MAX_SESSIONS` sessões simultâneas (padrão 1000).
|
|
621
621
|
|
|
622
622
|
### Configuração de MCP OAuth (OAuth nativo do Claude.ai)
|
|
@@ -692,7 +692,7 @@ Não é necessário definir `headers`. O Claude.ai obtém o token via OAuth.
|
|
|
692
692
|
| `GITLAB_API_URL` | sim | URL da API da instância GitLab (por exemplo, `https://gitlab.com/api/v4`). Não inclua credenciais (`user:pass@`) na URL; elas são ignoradas. Uma vírgula na senha deve ser escrita como `%2C`. |
|
|
693
693
|
| `STREAMABLE_HTTP` | sim | Deve ser `true` (SSE não é suportado) |
|
|
694
694
|
| `GITLAB_OAUTH_SCOPES` | não | Scopes do GitLab a solicitar, separados por vírgula. O padrão é `api`, ou `read_api` quando o permission mode efetivo é `readonly`. O aplicativo previamente registrado deve ter pelo menos esses scopes configurados. |
|
|
695
|
-
| `OAUTH_REGISTER_RATE_LIMIT_PER_HOUR` | não | Limite
|
|
695
|
+
| `OAUTH_REGISTER_RATE_LIMIT_PER_HOUR` | não | Limite por IP do cliente (janela fixa de 1 hora) de Dynamic Client Registration (`POST /register`). Padrão `20`/hora, intervalo `1`–`1000`. Aumente se múltiplas janelas de IDE estiverem atingindo o limite. Não está relacionado aos limites da API do GitLab. |
|
|
696
696
|
| `OAUTH_DISABLE_REFRESH_TOKEN` | não | Defina `true` para remover `refresh_token` das respostas de `/token` e rejeitar o refresh grant com `invalid_grant`; o usuário autoriza de novo no navegador quando o access token do GitLab expira. Padrão `false`. No modo de proxy de callback, clientes MCP que seguem o fluxo deste servidor nunca recebem um refresh token do GitLab (em passthrough o cliente pode obter um direto do GitLab). É uma política de reautorização para clientes MCP padrão, não uma barreira de segurança. Refresh tokens emitidos antes de ativar continuam válidos até serem revogados no GitLab em **User Settings → Applications → Authorized applications → Revoke**. |
|
|
697
697
|
| `MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL` | não | Apenas para desenvolvimento local via HTTP |
|
|
698
698
|
|
package/README.zh-CN.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
📖 **[文档 →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
|
|
8
8
|
|
|
9
|
-
**默认暴露 40 个工具**(38 个 `core` + `discover_tools` + `help`)。总共
|
|
9
|
+
**默认暴露 40 个工具**(38 个 `core` + `discover_tools` + `help`)。总共 287 个(toolset 中 284 个 + `execute_graphql` + `discover_tools` + `help`)。先用精简集,再在本会话中用 `discover_tools` 扩展。
|
|
10
10
|
|
|
11
11
|
先安装 `zereight-mcp-gitlab` 二进制。`npm install -g @zereight/mcp-gitlab`,或 Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` 然后 `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`。官方 MCP Registry 条目:[`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp)。一键安装:`npx -y @zereight/mcp-gitlab@latest`。
|
|
12
12
|
|
|
@@ -138,7 +138,7 @@ GitLab 合并请求、议题和流水线走此 MCP(@zereight/mcp-gitlab)。
|
|
|
138
138
|
|
|
139
139
|
### 为什么使用这个 GitLab MCP?
|
|
140
140
|
|
|
141
|
-
- **默认 40 个工具(38 个 `core` + `discover_tools` + `help`);共
|
|
141
|
+
- **默认 40 个工具(38 个 `core` + `discover_tools` + `help`);共 287 个** — 先精简,再用 `discover_tools` 在本会话扩展
|
|
142
142
|
- **MR 两步审查** — `list_merge_request_changed_files` → 批量 `get_merge_request_file_diff`
|
|
143
143
|
- **内置 Agent Skill** — `skills/gitlab-mcp/` 工作流指南
|
|
144
144
|
- **认证灵活** — Personal Access Token、本地 OAuth2 浏览器流程、MCP OAuth 代理、按请求远程授权
|
|
@@ -152,7 +152,7 @@ GitLab 合并请求、议题和流水线走此 MCP(@zereight/mcp-gitlab)。
|
|
|
152
152
|
| | @zereight/mcp-gitlab | GitLab MCP A(社区 CQRS 型) | GitLab 官方 MCP 服务器 |
|
|
153
153
|
| ------------ | -------------------------------------------------------------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
154
154
|
| **更适合** | AI 代理工作流 | 企业多实例 / 分组工具 | 内置于 GitLab,无需单独安装 |
|
|
155
|
-
| **工具模型** |
|
|
155
|
+
| **工具模型** | 287 个工具:toolset 中 284 个 + `execute_graphql` + `discover_tools` + `help` | ~50–60 个 `browse_*` / `manage_*` 分组工具 | 用 HTTP 头选择 toolset |
|
|
156
156
|
| **MR 审查** | 两步批量 diff | 因服务器而异 | `get_merge_request` 带 diffs |
|
|
157
157
|
| **Node.js** | >=20.0.0 | 通常 >=24 | stdio 经 `mcp-remote`,需要 Node.js 20+ |
|
|
158
158
|
| **许可证** | MIT | 因服务器而异 | GitLab 的一部分 |
|
|
@@ -252,7 +252,7 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
|
|
|
252
252
|
|
|
253
253
|
示例使用 `zereight-mcp-gitlab`,这是比旧的 `mcp-gitlab` 更不容易冲突的别名。如果 MCP 客户端找不到它,请使用 `which zereight-mcp-gitlab` 输出的绝对路径。
|
|
254
254
|
|
|
255
|
-
如果不想全局安装,请将 `npx` 固定到上一个稳定版本(即文档推荐的版本),例如 `npx -y @zereight/mcp-gitlab@2.3.
|
|
255
|
+
如果不想全局安装,请将 `npx` 固定到上一个稳定版本(即文档推荐的版本),例如 `npx -y @zereight/mcp-gitlab@2.3.16`。如果始终想使用最新版本,请改用 `npx -y @zereight/mcp-gitlab@latest`。如需在下一个稳定版本发布前试用已合并到 `main` 的修复,请使用 `npx -y @zereight/mcp-gitlab@next`(预发布版本,不适用于生产环境)。有新版本发布时,服务器会在启动时通过 stderr 提示(可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭)。
|
|
256
256
|
|
|
257
257
|
#### Claude Desktop 一键安装(MCP Bundle)
|
|
258
258
|
|
|
@@ -615,7 +615,7 @@ token 按会话存储(由 `mcp-session-id` 请求头标识),并在同一
|
|
|
615
615
|
- 每个会话相互隔离。一个会话的 token 不能访问另一个会话的数据。会话关闭后 token 会自动清理。
|
|
616
616
|
- **会话超时:** 认证 token 在 `SESSION_TIMEOUT_SECONDS`(默认 1 小时)无活动后过期。超时后,客户端必须再次发送认证请求头。传输会话仍保持活动。
|
|
617
617
|
- 每个请求都会重置该会话的超时计时器。
|
|
618
|
-
- **Rate limiting:** `/mcp` 请求按客户端 IP 限制为每分钟 `MAX_REQUESTS_PER_MINUTE` 次;使用 OAuth 或远程授权时还按 MCP 会话限制(默认 60
|
|
618
|
+
- **Rate limiting:** `/mcp` 请求按客户端 IP 限制为每分钟 `MAX_REQUESTS_PER_MINUTE` 次;使用 OAuth 或远程授权时还按 MCP 会话限制(默认 60)。按 IP 的限制使用固定 60 秒窗口,按服务器进程分别计数,并同样覆盖 `GET /mcp`;stateless 模式会跳过按会话的限制。详见 [environment-variables.md](docs/configuration/environment-variables.md#max_requests_per_minute)。
|
|
619
619
|
- **Capacity limit:** 服务器最多接受 `MAX_SESSIONS` 个并发会话(默认 1000)。
|
|
620
620
|
|
|
621
621
|
### MCP OAuth 设置(Claude.ai Native OAuth)
|
|
@@ -691,7 +691,7 @@ node build/index.js
|
|
|
691
691
|
| `GITLAB_API_URL` | 是 | GitLab 实例 API URL(例如 `https://gitlab.com/api/v4`)。不要在 URL 中嵌入凭据(`user:pass@`),嵌入的凭据会被忽略。密码中的逗号必须写成 `%2C`。 |
|
|
692
692
|
| `STREAMABLE_HTTP` | 是 | 必须为 `true`(不支持 SSE) |
|
|
693
693
|
| `GITLAB_OAUTH_SCOPES` | 否 | 要请求的 GitLab scopes,以逗号分隔。默认值为 `api`;有效 permission mode 为 `readonly` 时为 `read_api`。预注册应用必须配置至少这些 scopes。 |
|
|
694
|
-
| `OAUTH_REGISTER_RATE_LIMIT_PER_HOUR` | 否 | Dynamic Client Registration(`POST /register`)的每客户端 IP
|
|
694
|
+
| `OAUTH_REGISTER_RATE_LIMIT_PER_HOUR` | 否 | Dynamic Client Registration(`POST /register`)的每客户端 IP 限制(固定 1 小时窗口)。默认 `20`/小时,范围 `1`–`1000`。多个 IDE 窗口等导致注册被限流时可调高。与 GitLab API 限额无关。 |
|
|
695
695
|
| `OAUTH_DISABLE_REFRESH_TOKEN` | 否 | 设置 `true` 时 `/token` 响应不含 `refresh_token`,refresh grant 以 `invalid_grant` 拒绝;GitLab access token 过期后用户需在浏览器中重新授权。默认 `false`。回调代理模式下,遵循本服务器流程的 MCP 客户端拿不到 GitLab refresh token(passthrough 模式下客户端可直接从 GitLab 获取)。这是面向标准 MCP 客户端的重新授权策略,而非安全边界。启用前已发放的 refresh token 在 GitLab **User Settings → Applications → Authorized applications → Revoke** 撤销前仍然有效。 |
|
|
696
696
|
| `MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL` | 否 | 仅用于本地 HTTP 开发 |
|
|
697
697
|
|
package/package.json
CHANGED