@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 CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2025 Roo
3
+ Copyright (c) 2025-2026 zereight
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
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`). 전체는 278개(toolset 275개 + `execute_graphql` + `discover_tools` + `help`). 작게 시작하고, 세션에서 `discover_tools`로 확장하세요.
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`); 전체 278개** — 작게 시작하고, `discover_tools`로 세션에서 확장
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
- | **도구 모델** | 278개 도구: toolset 275개 + `execute_graphql` + `discover_tools` + `help` | ~50–60개 `browse_*` / `manage_*` 그룹 도구 | HTTP 헤더로 고르는 toolset |
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.15`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. `main`에 머지된 수정을 다음 안정 버전 전에 확인하려면 프리릴리스 빌드인 `npx -y @zereight/mcp-gitlab@next`를 사용하세요(운영 환경용이 아닙니다). 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
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당 rolling 한도. 기본 `20`/시간, 범위 `1`–`1000`. IDE 창 여러 개 등으로 등록이 막히면 올리세요. GitLab API 한도와 무관합니다. |
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`). 278 tools exist in total (275 in toolsets + `execute_graphql` + `discover_tools` + `help`). Start lean; call `discover_tools` to activate more for this session.
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`); 278 total** — start lean; call `discover_tools` to activate more without CQRS-style grouping
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** | 278 tools: 275 in toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 grouped `browse_*` / `manage_*` tools | Toolsets chosen with an HTTP header |
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.15`. 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`).
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 rolling limit 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. |
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. `upload_markdown` - Upload a file for use in markdown content
978
- 199. `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)
979
- 200. `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.
980
- 201. `list_events` - List events for the authenticated user (before/after: YYYY-MM-DD)
981
- 202. `get_project_events` - List events for a project (before/after: YYYY-MM-DD)
982
- 203. `list_releases` - List all releases for a project
983
- 204. `get_release` - Get a release by tag name
984
- 205. `create_release` - Create a new release
985
- 206. `update_release` - Update an existing release
986
- 207. `delete_release` - Delete a release (does not delete the tag)
987
- 208. `create_release_evidence` - Create release evidence (Premium/Ultimate)
988
- 209. `download_release_asset` - Download a release asset file by direct asset path
989
- 210. `list_tags` - List repository tags for a project
990
- 211. `get_tag` - Get a repository tag by name
991
- 212. `create_tag` - Create a new repository tag
992
- 213. `delete_tag` - Delete a repository tag
993
- 214. `get_tag_signature` - Get the X.509 signature of a signed tag (404 if unsigned)
994
- 215. `list_protected_tags` - List protected tags in a project
995
- 216. `get_protected_tag` - Get details of a single protected tag or wildcard (create access levels)
996
- 217. `protect_tag` - Protect a repository tag or wildcard (set who can create it)
997
- 218. `unprotect_tag` - Remove protection from a previously protected tag or wildcard
998
- 219. `get_work_item` - Get a work item with full details including status, hierarchy, type, and widgets
999
- 220. `list_work_items` - List work items with filters (type, state, search, assignees, labels)
1000
- 221. `create_work_item` - Create a work item (issue, task, incident, epic, etc.) with full field support
1001
- 222. `update_work_item` - Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)
1002
- 223. `convert_work_item_type` - Convert a work item to a different type
1003
- 224. `list_work_item_statuses` - List available statuses for a work item type (Premium/Ultimate)
1004
- 225. `list_custom_field_definitions` - List custom field definitions for a work item type
1005
- 226. `move_work_item` - Move a work item to a different project
1006
- 227. `list_work_item_notes` - List notes and discussions on a work item
1007
- 228. `create_work_item_note` - Add a note to a work item (supports Markdown, internal notes, threads)
1008
- 229. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
1009
- 230. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
1010
- 231. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
1011
- 232. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
1012
- 233. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
1013
- 234. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
1014
- 235. `get_timeline_events` - List timeline events for an incident
1015
- 236. `create_timeline_event` - Create a timeline event on an incident
1016
- 237. `list_webhooks` - List webhooks for a project or group
1017
- 238. `create_webhook` - Create a webhook on a project or group
1018
- 239. `update_webhook` - Update an existing project or group webhook
1019
- 240. `delete_webhook` - Delete a project or group webhook
1020
- 241. `list_webhook_events` - List recent webhook events (past 7 days)
1021
- 242. `get_webhook_event` - Get full details of a specific webhook event
1022
- 243. `search_code` - Search for code across all projects (requires advanced search or Zoekt)
1023
- 244. `search_project_code` - Search for code within a specific project (requires advanced search or Zoekt)
1024
- 245. `search_group_code` - Search for code within a specific group (requires advanced search or Zoekt)
1025
- 246. `list_project_variables` - List CI/CD variables for a project
1026
- 247. `get_project_variable` - Get a single CI/CD variable from a project
1027
- 248. `create_project_variable` - Create a CI/CD variable for a project
1028
- 249. `update_project_variable` - Update an existing CI/CD variable in a project
1029
- 250. `delete_project_variable` - Delete a CI/CD variable from a project
1030
- 251. `list_group_variables` - List CI/CD variables for a group
1031
- 252. `get_group_variable` - Get a single CI/CD variable from a group
1032
- 253. `create_group_variable` - Create a CI/CD variable for a group
1033
- 254. `update_group_variable` - Update an existing CI/CD variable in a group
1034
- 255. `delete_group_variable` - Delete a CI/CD variable from a group
1035
- 256. `get_dependency_proxy_settings` - Get dependency proxy settings for a group
1036
- 257. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
1037
- 258. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group
1038
- 259. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
1039
- 260. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
1040
- 261. `get_vulnerability` - Get full details of a specific vulnerability
1041
- 262. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
1042
- 263. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
1043
- 264. `orbit_query` - Execute a GitLab Orbit graph query over the indexed SDLC knowledge graph
1044
- 265. `orbit_get_schema` - Fetch the current GitLab Orbit graph schema (node and edge types)
1045
- 266. `orbit_get_status` - Check GitLab Orbit indexing status for the enabled scope
1046
- 267. `orbit_list_tools` - List the MCP tool definitions exposed by GitLab Orbit
1047
- 268. `list_snippets` - List snippets — project snippets when project_id is given, otherwise personal snippets
1048
- 269. `get_snippet` - Get a snippet's metadata. Set include_content=true to also fetch the raw file content.
1049
- 270. `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.
1050
- 271. `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.
1051
- 272. `delete_snippet` - Delete a snippet
1052
- 273. `list_project_runners` - List runners available to a project (type, status, paused, tag_list). Omits registration and authentication tokens.
1053
- 274. `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.
1054
- 275. `rebase_merge_request` - Rebase the source branch of a merge request onto its target branch
1055
- 276. `gitlab_api_request` - Send one GitLab REST call under /api/v4. Enabled only when GITLAB_TOOLSETS lists api. Readonly allows GET; modify rejects DELETE.
1056
- 277. `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.
1057
- 278. `help` - Return a short GitLab workflow guide. Omit topic for the overview and topic list.
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 278 no total (275 em toolsets + `execute_graphql` + `discover_tools` + `help`). Comece enxuto; chame `discover_tools` para ativar mais nesta sessão.
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`); 278 no total** — comece enxuto; chame `discover_tools` para expandir nesta sessão
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** | 278 ferramentas: 275 em toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 ferramentas agrupadas `browse_*` / `manage_*` | Toolsets escolhidos por cabeçalho HTTP |
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.15`. 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`).
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 rolling de Dynamic Client Registration (`POST /register`) por IP do cliente. 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. |
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`)。总共 278 个(toolset 中 275 个 + `execute_graphql` + `discover_tools` + `help`)。先用精简集,再在本会话中用 `discover_tools` 扩展。
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`);共 278 个** — 先精简,再用 `discover_tools` 在本会话扩展
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
- | **工具模型** | 278 个工具:toolset 中 275 个 + `execute_graphql` + `discover_tools` + `help` | ~50–60 个 `browse_*` / `manage_*` 分组工具 | 用 HTTP 头选择 toolset |
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.15`。如果始终想使用最新版本,请改用 `npx -y @zereight/mcp-gitlab@latest`。如需在下一个稳定版本发布前试用已合并到 `main` 的修复,请使用 `npx -y @zereight/mcp-gitlab@next`(预发布版本,不适用于生产环境)。有新版本发布时,服务器会在启动时通过 stderr 提示(可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭)。
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)。详见 [environment-variables.md](docs/configuration/environment-variables.md#max_requests_per_minute)。
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 rolling 限制。默认 `20`/小时,范围 `1`–`1000`。多个 IDE 窗口等导致注册被限流时可调高。与 GitLab API 限额无关。 |
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zereight/mcp-gitlab",
3
- "version": "2.3.16",
3
+ "version": "2.3.17",
4
4
  "mcpName": "io.github.zereight/gitlab-mcp",
5
5
  "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
6
6
  "keywords": [