@zereight/mcp-gitlab 2.3.16-next.183 → 2.3.17-next.186

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/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.14`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `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.15`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `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
 
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.14`. 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.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`).
262
262
 
263
263
  #### Claude Desktop one-click install (MCP Bundle)
264
264
 
@@ -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.14`. 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.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`).
256
256
 
257
257
  #### Instalação com um clique no Claude Desktop (MCP Bundle)
258
258
 
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.14`。如果始终想使用最新版本,请改用 `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.15`。如果始终想使用最新版本,请改用 `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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zereight/mcp-gitlab",
3
- "version": "2.3.16-next.183",
3
+ "version": "2.3.17-next.186",
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": [