@zereight/mcp-gitlab 2.1.52 → 2.1.53

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
@@ -13,8 +13,6 @@
13
13
 
14
14
  **에이전트 워크플로우에 최적화된 GitLab MCP** — stdio, SSE, Streamable HTTP를 통해 프로젝트, 머지 리퀘스트, 이슈, 파이프라인, 위키, 릴리스, 마일스톤 등을 관리할 수 있습니다.
15
15
 
16
- 동일한 서버가 [`@zereight/gitlab-mcp`](https://www.npmjs.com/package/@zereight/gitlab-mcp) 이름으로도 배포됩니다 (npm 검색용 별칭).
17
-
18
16
  PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며 VS Code, Claude, Cursor, Copilot 및 기타 MCP 클라이언트에서 사용할 수 있습니다.
19
17
 
20
18
  ### 왜 이 GitLab MCP를 사용하나요?
@@ -39,7 +37,7 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
39
37
 
40
38
  [전체 비교 →](./docs/comparison/community-gitlab-mcp-a.md)
41
39
 
42
- 빠른 시작: 아래에서 Personal Access Token 또는 OAuth2 설정 중 하나를 선택하고 `@zereight/mcp-gitlab`(또는 `@zereight/gitlab-mcp`)을 설치한 뒤 MCP 클라이언트 설정에서 `zereight-mcp-gitlab`을 사용하세요.
40
+ 빠른 시작: 아래에서 Personal Access Token 또는 OAuth2 설정 중 하나를 선택하고 `@zereight/mcp-gitlab`을 설치한 뒤 MCP 클라이언트 설정에서 `zereight-mcp-gitlab`을 사용하세요.
43
41
 
44
42
  ### 클라이언트 설정 가이드
45
43
 
@@ -92,17 +90,15 @@ brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp
92
90
  brew install zereight/gitlab-mcp/zereight-mcp-gitlab
93
91
  ```
94
92
 
95
- npm으로 설치할 수도 있습니다 (두 패키지명 모두 동일한 서버입니다):
93
+ npm으로 설치할 수도 있습니다:
96
94
 
97
95
  ```shell
98
96
  npm install -g @zereight/mcp-gitlab
99
- # 또는
100
- npm install -g @zereight/gitlab-mcp
101
97
  ```
102
98
 
103
99
  예시는 기존 `mcp-gitlab`보다 충돌 가능성이 낮은 `zereight-mcp-gitlab` 별칭을 사용합니다. MCP 클라이언트가 찾지 못하면 `which zereight-mcp-gitlab`의 절대 경로를 사용하세요.
104
100
 
105
- 전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.1.51`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
101
+ 전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.1.52`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
106
102
 
107
103
  #### CLI 인자 사용하기(환경 변수 문제가 있는 클라이언트용)
108
104
 
package/README.md CHANGED
@@ -14,13 +14,11 @@
14
14
 
15
15
  **Agent-workflow-optimized GitLab MCP** — manage projects, merge requests, issues, pipelines, wiki, releases, tags, milestones, and more through stdio, SSE, and Streamable HTTP.
16
16
 
17
- Also published as [`@zereight/gitlab-mcp`](https://www.npmjs.com/package/@zereight/gitlab-mcp) (search-friendly alias for the same server).
18
-
19
17
  Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization for VS Code, Claude, Cursor, Copilot, and other MCP clients.
20
18
 
21
19
  ### Why use this GitLab MCP?
22
20
 
23
- - **217 tools + `discover_tools`** — start with a small toolset; activate more at runtime without CQRS-style grouping
21
+ - **229 tools + `discover_tools`** — start with a small toolset; activate more at runtime without CQRS-style grouping
24
22
  - **MR 2-step review** — `list_merge_request_changed_files` → batched `get_merge_request_file_diff`
25
23
  - **Agent Skill built in** — workflow guidance in `skills/gitlab-mcp/`
26
24
  - **Flexible auth** — Personal Access Token, local OAuth2 browser flow, MCP OAuth proxy, and per-request remote authorization
@@ -33,14 +31,14 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
33
31
  | | @zereight/mcp-gitlab | GitLab MCP A (community CQRS-style) |
34
32
  |---|----------------------|-------------------------------------|
35
33
  | **Best for** | AI agent workflows | Enterprise multi-instance / grouped tools |
36
- | **Tool model** | ~217 granular tools + `discover_tools` | ~50–60 grouped `browse_*` / `manage_*` tools |
34
+ | **Tool model** | ~229 granular tools + `discover_tools` | ~50–60 grouped `browse_*` / `manage_*` tools |
37
35
  | **MR review** | 2-step batched diff | Varies |
38
36
  | **Node.js** | >=18 | Often >=24 |
39
37
  | **License** | MIT | Varies |
40
38
 
41
39
  [Full comparison →](./docs/comparison/community-gitlab-mcp-a.md)
42
40
 
43
- Quick start: choose either Personal Access Token or OAuth2 setup below, install `@zereight/mcp-gitlab` (or `@zereight/gitlab-mcp`), and use `zereight-mcp-gitlab` in your MCP client configuration.
41
+ Quick start: choose either Personal Access Token or OAuth2 setup below, install `@zereight/mcp-gitlab`, and use `zereight-mcp-gitlab` in your MCP client configuration.
44
42
 
45
43
  ### Client Setup Guides
46
44
 
@@ -93,17 +91,15 @@ brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp
93
91
  brew install zereight/gitlab-mcp/zereight-mcp-gitlab
94
92
  ```
95
93
 
96
- Or with npm (either package name installs the same server):
94
+ Or with npm:
97
95
 
98
96
  ```shell
99
97
  npm install -g @zereight/mcp-gitlab
100
- # or
101
- npm install -g @zereight/gitlab-mcp
102
98
  ```
103
99
 
104
100
  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`.
105
101
 
106
- No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.1.51`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
102
+ No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.1.52`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
107
103
 
108
104
  #### Using CLI Arguments (for clients with env var issues)
109
105
 
@@ -694,100 +690,113 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
694
690
  121. `create_pipeline` - Create a new pipeline for a branch or tag
695
691
  122. `retry_pipeline` - Retry a failed or canceled pipeline
696
692
  123. `cancel_pipeline` - Cancel a running pipeline
697
- 124. `play_pipeline_job` - Run a manual pipeline job
698
- 125. `retry_pipeline_job` - Retry a failed or canceled pipeline job
699
- 126. `cancel_pipeline_job` - Cancel a running pipeline job
700
- 127. `list_job_artifacts` - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes
701
- 128. `download_job_artifacts` - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path
702
- 129. `get_job_artifact_file` - Get the content of a single file from a job's artifacts by its path within the archive
703
- 130. `list_merge_requests` - List merge requests globally or in a specific GitLab project with filtering options (project_id is now optional)
704
- 131. `list_milestones` - List milestones in a GitLab project with filtering options
705
- 132. `get_milestone` - Get details of a specific milestone
706
- 133. `create_milestone` - Create a new milestone in a GitLab project
707
- 134. `edit_milestone` - Edit an existing milestone in a GitLab project
708
- 135. `delete_milestone` - Delete a milestone from a GitLab project
709
- 136. `get_milestone_issue` - Get issues associated with a specific milestone
710
- 137. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
711
- 138. `promote_milestone` - Promote a milestone to the next stage
712
- 139. `get_milestone_burndown_events` - Get burndown events for a specific milestone
713
- 140. `list_group_milestones` - List milestones in a GitLab group with filtering options
714
- 141. `get_group_milestone` - Get details of a specific group milestone
715
- 142. `create_group_milestone` - Create a new milestone in a GitLab group
716
- 143. `edit_group_milestone` - Edit an existing group milestone
717
- 144. `delete_group_milestone` - Delete a milestone from a GitLab group
718
- 145. `get_group_milestone_issue` - Get issues associated with a specific group milestone
719
- 146. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
720
- 147. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
721
- 148. `get_users` - Get GitLab user details by usernames
722
- 149. `get_user` - Get user details by ID
723
- 150. `whoami` - Get current authenticated user details
724
- 151. `list_commits` - List repository commits with filtering options
725
- 152. `get_commit` - Get details of a specific commit
726
- 153. `get_commit_diff` - Get changes/diffs of a specific commit
727
- 154. `get_file_blame` - Get git blame for a file at a given ref. Each entry maps a contiguous range of source lines to the commit that last changed them (id, author, authored_date, message). Use range_start/range_end to limit blame to specific lines.
728
- 155. `list_commit_statuses` - List statuses for a specific commit
729
- 156. `create_commit_status` - Create or update the status of a specific commit
730
- 157. `list_group_iterations` - List group iterations with filtering options
731
- 158. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
732
- 159. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
733
- 160. `health_check` - Verify server status and authentication; when authenticated, reports GitLab instance version from `/api/v4/version` (`version`, `revision`, `enterprise`)
734
- 161. `list_events` - List all events for the currently authenticated user
735
- 162. `get_project_events` - List all visible events for a specified project
736
- 163. `list_releases` - List all releases for a project
737
- 164. `get_release` - Get a release by tag name
738
- 165. `create_release` - Create a new release in a GitLab project
739
- 166. `update_release` - Update an existing release in a GitLab project
740
- 167. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
741
- 168. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
742
- 169. `download_release_asset` - Download a release asset file by direct asset path
743
- 170. `list_tags` - List repository tags with filtering and pagination support
744
- 171. `get_tag` - Get details of a specific repository tag
745
- 172. `create_tag` - Create a new tag in the repository
746
- 173. `delete_tag` - Delete a tag from the repository
747
- 174. `get_tag_signature` - Get the signature of a signed tag
748
- 175. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
749
- 176. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
750
- 177. `create_work_item` - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality
751
- 178. `update_work_item` - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields
752
- 179. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
753
- 180. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
754
- 181. `list_custom_field_definitions` - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item
755
- 182. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
756
- 183. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
757
- 184. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
758
- 185. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
759
- 186. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
760
- 187. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
761
- 188. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
762
- 189. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
763
- 190. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
764
- 191. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
765
- 192. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
766
- 193. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
767
- 194. `list_webhook_events` - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details
768
- 195. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
769
- 196. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
770
- 197. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
771
- 198. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
772
- 199. `list_project_variables` - List CI/CD variables for a project with optional environment scope filter
773
- 200. `get_project_variable` - Get a single CI/CD variable from a project by key, with optional environment scope filter
774
- 201. `create_project_variable` - Create a new CI/CD variable in a project
775
- 202. `update_project_variable` - Update an existing CI/CD variable in a project, with optional filter to disambiguate by environment scope
776
- 203. `delete_project_variable` - Delete a CI/CD variable from a project, with optional filter to disambiguate by environment scope
777
- 204. `list_group_variables` - List CI/CD variables for a group with optional environment scope filter
778
- 205. `get_group_variable` - Get a single CI/CD variable from a group by key, with optional environment scope filter
779
- 206. `create_group_variable` - Create a new CI/CD variable in a group
780
- 207. `update_group_variable` - Update an existing CI/CD variable in a group, with optional filter to disambiguate by environment scope
781
- 208. `delete_group_variable` - Delete a CI/CD variable from a group, with optional filter to disambiguate by environment scope
782
- 209. `get_dependency_proxy_settings` - Get dependency proxy settings for a group (enabled status, blob count, total size, image prefix, TTL policy)
783
- 210. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
784
- 211. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group with cursor-based pagination
785
- 212. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
786
- 213. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
787
- 214. `get_vulnerability` - Get full details of a specific vulnerability
788
- 215. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
789
- 216. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
790
- 217. `discover_tools` - Discover and activate additional tool categories for this session. Available categories: merge_requests, issues, repositories, branches, projects, labels, ci, groups, pipelines, milestones, wiki, releases, tags, users, workitems, webhooks, search, variables, dependency_proxy, vulnerabilities. Already-active categories are listed in the response.
693
+ 124. `list_pipeline_schedules` - List pipeline schedules in a project, optionally filtered to active or inactive
694
+ 125. `get_pipeline_schedule` - Get details of a specific pipeline schedule, including its variables and last pipeline
695
+ 126. `list_pipeline_schedule_pipelines` - List the pipelines that a pipeline schedule has triggered
696
+ 127. `create_pipeline_schedule` - Create a new pipeline schedule for a branch or tag
697
+ 128. `update_pipeline_schedule` - Update an existing pipeline schedule
698
+ 129. `delete_pipeline_schedule` - Delete a pipeline schedule
699
+ 130. `play_pipeline_schedule` - Run a pipeline schedule immediately, without changing its next scheduled run
700
+ 131. `take_ownership_pipeline_schedule` - Take ownership of a pipeline schedule
701
+ 132. `get_pipeline_schedule_variable` - Get a single variable of a pipeline schedule
702
+ 133. `create_pipeline_schedule_variable` - Create a variable for a pipeline schedule
703
+ 134. `update_pipeline_schedule_variable` - Update a variable of a pipeline schedule
704
+ 135. `delete_pipeline_schedule_variable` - Delete a variable from a pipeline schedule
705
+ 136. `play_pipeline_job` - Run a manual pipeline job
706
+ 137. `retry_pipeline_job` - Retry a failed or canceled pipeline job
707
+ 138. `cancel_pipeline_job` - Cancel a running pipeline job
708
+ 139. `list_job_artifacts` - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes
709
+ 140. `download_job_artifacts` - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path
710
+ 141. `get_job_artifact_file` - Get the content of a single file from a job's artifacts by its path within the archive
711
+ 142. `list_merge_requests` - List merge requests globally or in a specific GitLab project with filtering options (project_id is now optional)
712
+ 143. `list_group_merge_requests` - List merge requests across all projects of a group and its subgroups with filtering options
713
+ 144. `list_milestones` - List milestones in a GitLab project with filtering options
714
+ 145. `get_milestone` - Get details of a specific milestone
715
+ 146. `create_milestone` - Create a new milestone in a GitLab project
716
+ 147. `edit_milestone` - Edit an existing milestone in a GitLab project
717
+ 148. `delete_milestone` - Delete a milestone from a GitLab project
718
+ 149. `get_milestone_issue` - Get issues associated with a specific milestone
719
+ 150. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
720
+ 151. `promote_milestone` - Promote a milestone to the next stage
721
+ 152. `get_milestone_burndown_events` - Get burndown events for a specific milestone
722
+ 153. `list_group_milestones` - List milestones in a GitLab group with filtering options
723
+ 154. `get_group_milestone` - Get details of a specific group milestone
724
+ 155. `create_group_milestone` - Create a new milestone in a GitLab group
725
+ 156. `edit_group_milestone` - Edit an existing group milestone
726
+ 157. `delete_group_milestone` - Delete a milestone from a GitLab group
727
+ 158. `get_group_milestone_issue` - Get issues associated with a specific group milestone
728
+ 159. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
729
+ 160. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
730
+ 161. `get_users` - Get GitLab user details by usernames
731
+ 162. `get_user` - Get user details by ID
732
+ 163. `whoami` - Get current authenticated user details
733
+ 164. `list_commits` - List repository commits with filtering options
734
+ 165. `get_commit` - Get details of a specific commit
735
+ 166. `get_commit_diff` - Get changes/diffs of a specific commit
736
+ 167. `get_file_blame` - Get git blame for a file at a given ref. Each entry maps a contiguous range of source lines to the commit that last changed them (id, author, authored_date, message). Use range_start/range_end to limit blame to specific lines.
737
+ 168. `list_commit_statuses` - List statuses for a specific commit
738
+ 169. `create_commit_status` - Create or update the status of a specific commit
739
+ 170. `list_group_iterations` - List group iterations with filtering options
740
+ 171. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
741
+ 172. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
742
+ 173. `health_check` - Verify server status and authentication; when authenticated, reports GitLab instance version from `/api/v4/version` (`version`, `revision`, `enterprise`)
743
+ 174. `list_events` - List all events for the currently authenticated user
744
+ 175. `get_project_events` - List all visible events for a specified project
745
+ 176. `list_releases` - List all releases for a project
746
+ 177. `get_release` - Get a release by tag name
747
+ 178. `create_release` - Create a new release in a GitLab project
748
+ 179. `update_release` - Update an existing release in a GitLab project
749
+ 180. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
750
+ 181. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
751
+ 182. `download_release_asset` - Download a release asset file by direct asset path
752
+ 183. `list_tags` - List repository tags with filtering and pagination support
753
+ 184. `get_tag` - Get details of a specific repository tag
754
+ 185. `create_tag` - Create a new tag in the repository
755
+ 186. `delete_tag` - Delete a tag from the repository
756
+ 187. `get_tag_signature` - Get the signature of a signed tag
757
+ 188. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
758
+ 189. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
759
+ 190. `create_work_item` - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality
760
+ 191. `update_work_item` - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields
761
+ 192. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
762
+ 193. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
763
+ 194. `list_custom_field_definitions` - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item
764
+ 195. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
765
+ 196. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
766
+ 197. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
767
+ 198. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
768
+ 199. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
769
+ 200. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
770
+ 201. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
771
+ 202. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
772
+ 203. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
773
+ 204. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
774
+ 205. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
775
+ 206. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
776
+ 207. `list_webhook_events` - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details
777
+ 208. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
778
+ 209. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
779
+ 210. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
780
+ 211. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
781
+ 212. `list_project_variables` - List CI/CD variables for a project with optional environment scope filter
782
+ 213. `get_project_variable` - Get a single CI/CD variable from a project by key, with optional environment scope filter
783
+ 214. `create_project_variable` - Create a new CI/CD variable in a project
784
+ 215. `update_project_variable` - Update an existing CI/CD variable in a project, with optional filter to disambiguate by environment scope
785
+ 216. `delete_project_variable` - Delete a CI/CD variable from a project, with optional filter to disambiguate by environment scope
786
+ 217. `list_group_variables` - List CI/CD variables for a group with optional environment scope filter
787
+ 218. `get_group_variable` - Get a single CI/CD variable from a group by key, with optional environment scope filter
788
+ 219. `create_group_variable` - Create a new CI/CD variable in a group
789
+ 220. `update_group_variable` - Update an existing CI/CD variable in a group, with optional filter to disambiguate by environment scope
790
+ 221. `delete_group_variable` - Delete a CI/CD variable from a group, with optional filter to disambiguate by environment scope
791
+ 222. `get_dependency_proxy_settings` - Get dependency proxy settings for a group (enabled status, blob count, total size, image prefix, TTL policy)
792
+ 223. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
793
+ 224. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group with cursor-based pagination
794
+ 225. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
795
+ 226. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
796
+ 227. `get_vulnerability` - Get full details of a specific vulnerability
797
+ 228. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
798
+ 229. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
799
+ 230. `discover_tools` - Discover and activate additional tool categories for this session. Available categories: merge_requests, issues, repositories, branches, projects, labels, ci, groups, pipelines, milestones, wiki, releases, tags, users, workitems, webhooks, search, variables, dependency_proxy, vulnerabilities. Already-active categories are listed in the response.
791
800
 
792
801
  <!-- TOOLS-END -->
793
802
 
package/README.zh-CN.md CHANGED
@@ -13,8 +13,6 @@
13
13
 
14
14
  **面向 AI 代理工作流优化的 GitLab MCP** — 可通过 stdio、SSE 和 Streamable HTTP 管理项目、合并请求、议题、流水线、Wiki、发布、里程碑等。
15
15
 
16
- 同一服务器也以 [`@zereight/gitlab-mcp`](https://www.npmjs.com/package/@zereight/gitlab-mcp) 名称发布(便于 npm 搜索的别名)。
17
-
18
16
  支持 PAT、OAuth、只读模式、动态 API URL 和远程授权,可用于 VS Code、Claude、Cursor、Copilot 以及其他 MCP 客户端。
19
17
 
20
18
  ### 为什么使用这个 GitLab MCP?
@@ -39,7 +37,7 @@
39
37
 
40
38
  [完整对比 →](./docs/comparison/community-gitlab-mcp-a.md)
41
39
 
42
- 快速开始:在下面选择 Personal Access Token 或 OAuth2 设置,安装 `@zereight/mcp-gitlab`(或 `@zereight/gitlab-mcp`),并在 MCP 客户端配置中使用 `zereight-mcp-gitlab`。
40
+ 快速开始:在下面选择 Personal Access Token 或 OAuth2 设置,安装 `@zereight/mcp-gitlab`,并在 MCP 客户端配置中使用 `zereight-mcp-gitlab`。
43
41
 
44
42
  ### 客户端设置指南
45
43
 
@@ -92,17 +90,15 @@ brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp
92
90
  brew install zereight/gitlab-mcp/zereight-mcp-gitlab
93
91
  ```
94
92
 
95
- 也可以使用 npm 安装(两个包名安装的是同一服务器):
93
+ 也可以使用 npm 安装:
96
94
 
97
95
  ```shell
98
96
  npm install -g @zereight/mcp-gitlab
99
- # 或
100
- npm install -g @zereight/gitlab-mcp
101
97
  ```
102
98
 
103
99
  示例使用 `zereight-mcp-gitlab`,这是比旧的 `mcp-gitlab` 更不容易冲突的别名。如果 MCP 客户端找不到它,请使用 `which zereight-mcp-gitlab` 输出的绝对路径。
104
100
 
105
- 如果不想全局安装,请将 `npx` 固定到上一个稳定版本(即文档推荐的版本),例如 `npx -y @zereight/mcp-gitlab@2.1.51`。如果始终想使用最新版本,请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时,服务器会在启动时通过 stderr 提示(可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭)。
101
+ 如果不想全局安装,请将 `npx` 固定到上一个稳定版本(即文档推荐的版本),例如 `npx -y @zereight/mcp-gitlab@2.1.52`。如果始终想使用最新版本,请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时,服务器会在启动时通过 stderr 提示(可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭)。
106
102
 
107
103
  #### 使用 CLI 参数(适用于环境变量有问题的客户端)
108
104