@zereight/mcp-gitlab 2.3.28 → 2.3.29-next.249
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 +3 -3
- package/README.md +212 -210
- package/README.pt-BR.md +3 -3
- package/README.zh-CN.md +3 -3
- package/build/index.js +72 -1
- package/build/masking/engine.js +389 -3
- package/build/schemas.js +19 -0
- package/build/server/mcp-help.js +1 -0
- package/build/tools/registry.js +15 -1
- package/build/utils/list-summary.js +6 -2
- package/package.json +2 -2
package/README.ko.md
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
|
|
15
15
|
📖 **[문서 →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
|
|
16
16
|
|
|
17
|
-
**기본 노출: 40개 도구** (`core` 38개 + `discover_tools` + `help`). 전체는
|
|
17
|
+
**기본 노출: 40개 도구** (`core` 38개 + `discover_tools` + `help`). 전체는 290개(toolset 287개 + `execute_graphql` + `discover_tools` + `help`). 작게 시작하고, 세션에서 `discover_tools`로 확장하세요.
|
|
18
18
|
|
|
19
19
|
> **토큰 예산:** MCP 클라이언트는 세션 시작 때 `tools/list` 전체를 모델에 보냅니다. 기본값(~40개 도구, 스키마 ~12k 토큰)을 유지하세요. 확장은 `discover_tools`로 이 세션에만 카테고리를 켜거나(`OAUTH_STATELESS_MODE=true`면 `GITLAB_TOOLSETS`로 남기세요), [Skill + CLI](./docs/getting-started/cli-without-mcp.md)로 MCP 스키마를 건너뛰세요. **`GITLAB_TOOLSETS=all`은 쓰지 마세요** — 거의 모든 도구를 올려 스키마만 ~73k 토큰입니다. [tools/list 크기](#toolslist-크기-2026-11-14-실측)와 [비교](./docs/comparison/index.md)를 보세요.
|
|
20
20
|
|
|
@@ -148,7 +148,7 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
|
|
|
148
148
|
|
|
149
149
|
### 왜 이 GitLab MCP를 사용하나요?
|
|
150
150
|
|
|
151
|
-
- **기본 40개 도구(`core` 38 + `discover_tools` + `help`); 전체
|
|
151
|
+
- **기본 40개 도구(`core` 38 + `discover_tools` + `help`); 전체 290개** — 작게 시작하고, `discover_tools`로 세션에서 확장. `GITLAB_TOOLSETS=all`은 스키마 ~73k 토큰; 필요할 때만 켜거나 Skill + CLI를 쓰세요
|
|
152
152
|
- **MR 2단계 리뷰** — `list_merge_request_changed_files` → 배치 `get_merge_request_file_diff`
|
|
153
153
|
- **Agent Skill 내장** — `skills/gitlab-mcp/` 워크플로우 가이드
|
|
154
154
|
- **유연한 인증** — Personal Access Token, 로컬 OAuth2 브라우저 플로우, MCP OAuth 프록시, 요청별 원격 인증
|
|
@@ -162,7 +162,7 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
|
|
|
162
162
|
| | @zereight/mcp-gitlab | GitLab MCP A (커뮤니티 CQRS형) | GitLab 공식 MCP 서버 |
|
|
163
163
|
| --------------- | ---------------------------------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
164
164
|
| **적합한 경우** | AI 에이전트 워크플로우 | 엔터프라이즈 멀티 인스턴스 / 그룹형 도구 | GitLab에 내장, 별도 설치 없음 |
|
|
165
|
-
| **도구 모델** |
|
|
165
|
+
| **도구 모델** | 290개 도구: toolset 287개 + `execute_graphql` + `discover_tools` + `help` | ~50–60개 `browse_*` / `manage_*` 그룹 도구 | HTTP 헤더로 고르는 toolset |
|
|
166
166
|
| **MR 리뷰** | 2단계 배치 diff | 서버마다 다름 | `get_merge_request`에 diffs |
|
|
167
167
|
| **Node.js** | >=20.0.0 | 보통 >=24 | stdio는 `mcp-remote`, Node.js 20+ |
|
|
168
168
|
| **라이선스** | MIT | 서버마다 다름 | GitLab의 일부 |
|
package/README.md
CHANGED
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
|
|
20
20
|
📖 **[Documentation →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
|
|
21
21
|
|
|
22
|
-
**Default: 40 tools** (38 `core` + `discover_tools` + `help`).
|
|
22
|
+
**Default: 40 tools** (38 `core` + `discover_tools` + `help`). 290 tools exist in total (287 in toolsets + `execute_graphql` + `discover_tools` + `help`). Start lean; call `discover_tools` to activate more for this session.
|
|
23
23
|
|
|
24
24
|
> **Token budget:** MCP clients send the whole `tools/list` to the model at session start. Keep the default (~40 tools, ~12k schema tokens). Call `discover_tools` to activate a category for this session (session-only; with `OAUTH_STATELESS_MODE=true` persist a named `GITLAB_TOOLSETS` list), or use [Skill + CLI](./docs/getting-started/cli-without-mcp.md) and skip MCP schemas. **Do not set `GITLAB_TOOLSETS=all`** — it loads ~all tools and costs ~73k schema tokens. See [tools/list size](#toolslist-size-measured-2026-11-14) and [comparison](./docs/comparison/index.md).
|
|
25
25
|
|
|
@@ -153,7 +153,7 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
|
|
|
153
153
|
|
|
154
154
|
### Why use this GitLab MCP?
|
|
155
155
|
|
|
156
|
-
- **Default 40 tools (38 `core` + `discover_tools` + `help`);
|
|
156
|
+
- **Default 40 tools (38 `core` + `discover_tools` + `help`); 290 total** — start lean; call `discover_tools` to activate more without CQRS-style grouping. `GITLAB_TOOLSETS=all` loads ~all schemas (~73k tokens); prefer discover-on-demand or Skill + CLI
|
|
157
157
|
- **MR 2-step review** — `list_merge_request_changed_files` → batched `get_merge_request_file_diff`
|
|
158
158
|
- **Agent Skill built in** — workflow guidance in `skills/gitlab-mcp/`
|
|
159
159
|
- **Flexible auth** — Personal Access Token, local OAuth2 browser flow, MCP OAuth proxy, and per-request remote authorization
|
|
@@ -167,7 +167,7 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
|
|
|
167
167
|
| | @zereight/mcp-gitlab | GitLab MCP A (community CQRS-style) | GitLab official MCP server |
|
|
168
168
|
| -------------- | ----------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
169
169
|
| **Best for** | AI agent workflows | Enterprise multi-instance / grouped tools | Built into GitLab, no separate install |
|
|
170
|
-
| **Tool model** |
|
|
170
|
+
| **Tool model** | 290 tools: 287 in toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 grouped `browse_*` / `manage_*` tools | Toolsets chosen with an HTTP header |
|
|
171
171
|
| **MR review** | 2-step batched diff | Varies | `get_merge_request` with diffs |
|
|
172
172
|
| **Node.js** | >=20.0.0 | Often >=24 | Node.js 20+ for stdio via `mcp-remote` |
|
|
173
173
|
| **License** | MIT | Varies | Part of GitLab |
|
|
@@ -874,213 +874,215 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
|
|
|
874
874
|
79. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
|
|
875
875
|
80. `list_issue_links` - List all issue links for a specific issue
|
|
876
876
|
81. `list_issue_discussions` - List discussions for an issue
|
|
877
|
-
82. `
|
|
878
|
-
83. `
|
|
879
|
-
84. `
|
|
880
|
-
85. `
|
|
881
|
-
86. `
|
|
882
|
-
87. `
|
|
883
|
-
88. `
|
|
884
|
-
89. `
|
|
885
|
-
90. `
|
|
886
|
-
91. `
|
|
887
|
-
92. `
|
|
888
|
-
93. `
|
|
889
|
-
94. `
|
|
890
|
-
95. `
|
|
891
|
-
96. `
|
|
892
|
-
97. `
|
|
893
|
-
98. `
|
|
894
|
-
99. `
|
|
895
|
-
100. `
|
|
896
|
-
101. `
|
|
897
|
-
102. `
|
|
898
|
-
103. `
|
|
899
|
-
104. `
|
|
900
|
-
105. `
|
|
901
|
-
106. `
|
|
902
|
-
107. `
|
|
903
|
-
108. `
|
|
904
|
-
109. `
|
|
905
|
-
110. `
|
|
906
|
-
111. `
|
|
907
|
-
112. `
|
|
908
|
-
113. `
|
|
909
|
-
114. `
|
|
910
|
-
115. `
|
|
911
|
-
116. `
|
|
912
|
-
117. `
|
|
913
|
-
118. `
|
|
914
|
-
119. `
|
|
915
|
-
120. `
|
|
916
|
-
121. `
|
|
917
|
-
122. `
|
|
918
|
-
123. `
|
|
919
|
-
124. `
|
|
920
|
-
125. `
|
|
921
|
-
126. `
|
|
922
|
-
127. `
|
|
923
|
-
128. `
|
|
924
|
-
129. `
|
|
925
|
-
130. `
|
|
926
|
-
131. `
|
|
927
|
-
132. `
|
|
928
|
-
133. `
|
|
929
|
-
134. `
|
|
930
|
-
135. `
|
|
931
|
-
136. `
|
|
932
|
-
137. `
|
|
933
|
-
138. `
|
|
934
|
-
139. `
|
|
935
|
-
140. `
|
|
936
|
-
141. `
|
|
937
|
-
142. `
|
|
938
|
-
143. `
|
|
939
|
-
144. `
|
|
940
|
-
145. `
|
|
941
|
-
146. `
|
|
942
|
-
147. `
|
|
943
|
-
148. `
|
|
944
|
-
149. `
|
|
945
|
-
150. `
|
|
946
|
-
151. `
|
|
947
|
-
152. `
|
|
948
|
-
153. `
|
|
949
|
-
154. `
|
|
950
|
-
155. `
|
|
951
|
-
156. `
|
|
952
|
-
157. `
|
|
953
|
-
158. `
|
|
954
|
-
159. `
|
|
955
|
-
160. `
|
|
956
|
-
161. `
|
|
957
|
-
162. `
|
|
958
|
-
163. `
|
|
959
|
-
164. `
|
|
960
|
-
165. `
|
|
961
|
-
166. `
|
|
962
|
-
167. `
|
|
963
|
-
168. `
|
|
964
|
-
169. `
|
|
965
|
-
170. `
|
|
966
|
-
171. `
|
|
967
|
-
172. `
|
|
968
|
-
173. `
|
|
969
|
-
174. `
|
|
970
|
-
175. `
|
|
971
|
-
176. `
|
|
972
|
-
177. `
|
|
973
|
-
178. `
|
|
974
|
-
179. `
|
|
975
|
-
180. `
|
|
976
|
-
181. `
|
|
977
|
-
182. `
|
|
978
|
-
183. `
|
|
979
|
-
184. `
|
|
980
|
-
185. `
|
|
981
|
-
186. `
|
|
982
|
-
187. `
|
|
983
|
-
188. `
|
|
984
|
-
189. `
|
|
985
|
-
190. `
|
|
986
|
-
191. `
|
|
987
|
-
192. `
|
|
988
|
-
193. `
|
|
989
|
-
194. `
|
|
990
|
-
195. `
|
|
991
|
-
196. `
|
|
992
|
-
197. `
|
|
993
|
-
198. `
|
|
994
|
-
199. `
|
|
995
|
-
200. `
|
|
996
|
-
201. `
|
|
997
|
-
202. `
|
|
998
|
-
203. `
|
|
999
|
-
204. `
|
|
1000
|
-
205. `
|
|
1001
|
-
206. `
|
|
1002
|
-
207. `
|
|
1003
|
-
208. `
|
|
1004
|
-
209. `
|
|
1005
|
-
210. `
|
|
1006
|
-
211. `
|
|
1007
|
-
212. `
|
|
1008
|
-
213. `
|
|
1009
|
-
214. `
|
|
1010
|
-
215. `
|
|
1011
|
-
216. `
|
|
1012
|
-
217. `
|
|
1013
|
-
218. `
|
|
1014
|
-
219. `
|
|
1015
|
-
220. `
|
|
1016
|
-
221. `
|
|
1017
|
-
222. `
|
|
1018
|
-
223. `
|
|
1019
|
-
224. `
|
|
1020
|
-
225. `
|
|
1021
|
-
226. `
|
|
1022
|
-
227. `
|
|
1023
|
-
228. `
|
|
1024
|
-
229. `
|
|
1025
|
-
230. `
|
|
1026
|
-
231. `
|
|
1027
|
-
232. `
|
|
1028
|
-
233. `
|
|
1029
|
-
234. `
|
|
1030
|
-
235. `
|
|
1031
|
-
236. `
|
|
1032
|
-
237. `
|
|
1033
|
-
238. `
|
|
1034
|
-
239. `
|
|
1035
|
-
240. `
|
|
1036
|
-
241. `
|
|
1037
|
-
242. `
|
|
1038
|
-
243. `
|
|
1039
|
-
244. `
|
|
1040
|
-
245. `
|
|
1041
|
-
246. `
|
|
1042
|
-
247. `
|
|
1043
|
-
248. `
|
|
1044
|
-
249. `
|
|
1045
|
-
250. `
|
|
1046
|
-
251. `
|
|
1047
|
-
252. `
|
|
1048
|
-
253. `
|
|
1049
|
-
254. `
|
|
1050
|
-
255. `
|
|
1051
|
-
256. `
|
|
1052
|
-
257. `
|
|
1053
|
-
258. `
|
|
1054
|
-
259. `
|
|
1055
|
-
260. `
|
|
1056
|
-
261. `
|
|
1057
|
-
262. `
|
|
1058
|
-
263. `
|
|
1059
|
-
264. `
|
|
1060
|
-
265. `
|
|
1061
|
-
266. `
|
|
1062
|
-
267. `
|
|
1063
|
-
268. `
|
|
1064
|
-
269. `
|
|
1065
|
-
270. `
|
|
1066
|
-
271. `
|
|
1067
|
-
272. `
|
|
1068
|
-
273. `
|
|
1069
|
-
274. `
|
|
1070
|
-
275. `
|
|
1071
|
-
276. `
|
|
1072
|
-
277. `
|
|
1073
|
-
278. `
|
|
1074
|
-
279. `
|
|
1075
|
-
280. `
|
|
1076
|
-
281. `
|
|
1077
|
-
282. `
|
|
1078
|
-
283. `
|
|
1079
|
-
284. `
|
|
1080
|
-
285. `
|
|
1081
|
-
286. `
|
|
1082
|
-
287. `
|
|
1083
|
-
288. `
|
|
877
|
+
82. `list_issue_label_events` - List an issue's label history: who added or removed which label, when. Lean events: created_at, user.username, action, label.name (label is null if deleted). Paginated via page/per_page.
|
|
878
|
+
83. `list_issue_state_events` - List an issue's state history: who closed or reopened it, when. Lean events: created_at, user.username, state. Paginated via page/per_page.
|
|
879
|
+
84. `get_issue_link` - Get a specific issue link
|
|
880
|
+
85. `create_issue_link` - Create an issue link between two issues
|
|
881
|
+
86. `delete_issue_link` - Delete an issue link
|
|
882
|
+
87. `list_namespaces` - List all namespaces (users and groups) available to the current user. Filter by kind='group' for groups only.
|
|
883
|
+
88. `get_namespace` - Get details of a namespace (user or group) by ID or path. Groups are namespaces with kind='group'.
|
|
884
|
+
89. `verify_namespace` - Verify if a namespace path exists. Use parent_id to scope the check to a specific parent namespace — required for nested namespaces where the same path may exist under different parents.
|
|
885
|
+
90. `get_project` - Get details of a specific project
|
|
886
|
+
91. `list_projects` - List projects accessible by the current user
|
|
887
|
+
92. `update_project` - Update project settings such as description, visibility, default branch, and feature access levels
|
|
888
|
+
93. `list_project_members` - List members of a GitLab project
|
|
889
|
+
94. `list_group_members` - List members of a GitLab group with optional name or username search
|
|
890
|
+
95. `list_labels` - List labels for a project
|
|
891
|
+
96. `get_label` - Get a single label from a project
|
|
892
|
+
97. `create_label` - Create a new label in a project
|
|
893
|
+
98. `update_label` - Update an existing label in a project
|
|
894
|
+
99. `delete_label` - Delete a label from a project
|
|
895
|
+
100. `list_group_projects` - List projects in a group
|
|
896
|
+
101. `list_wiki_pages` - List wiki pages in a project
|
|
897
|
+
102. `get_wiki_page` - Get details of a specific wiki page
|
|
898
|
+
103. `create_wiki_page` - Create a wiki page in a project
|
|
899
|
+
104. `update_wiki_page` - Update a wiki page in a project
|
|
900
|
+
105. `delete_wiki_page` - Delete a wiki page from a project
|
|
901
|
+
106. `list_group_wiki_pages` - List wiki pages in a group
|
|
902
|
+
107. `get_group_wiki_page` - Get details of a specific group wiki page
|
|
903
|
+
108. `create_group_wiki_page` - Create a wiki page in a group
|
|
904
|
+
109. `update_group_wiki_page` - Update a wiki page in a group
|
|
905
|
+
110. `delete_group_wiki_page` - Delete a wiki page from a group
|
|
906
|
+
111. `get_repository_tree` - List files and directories in a repository
|
|
907
|
+
112. `list_pipelines` - List pipelines with filtering options
|
|
908
|
+
113. `get_pipeline` - Get details of a specific pipeline
|
|
909
|
+
114. `get_pipeline_variables` - Get variables configured for a pipeline
|
|
910
|
+
115. `get_pipeline_test_report` - Get pipeline test report
|
|
911
|
+
116. `get_pipeline_test_report_summary` - Get pipeline test report summary
|
|
912
|
+
117. `delete_pipeline` - Delete a pipeline. Requires the project Owner role, cannot be undone, and does not automatically delete child pipelines.
|
|
913
|
+
118. `update_pipeline_metadata` - Update pipeline metadata
|
|
914
|
+
119. `list_deployments` - List deployments with filtering options
|
|
915
|
+
120. `get_deployment` - Get deployment details, including approval_summary, approvals, and pending_approval_count when GitLab provides them
|
|
916
|
+
121. `create_deployment` - Create a deployment
|
|
917
|
+
122. `update_deployment` - Update a deployment status
|
|
918
|
+
123. `delete_deployment` - Delete a deployment
|
|
919
|
+
124. `list_deployment_merge_requests` - List merge requests shipped with a deployment
|
|
920
|
+
125. `approve_deployment` - Approve or reject a protected-environment deployment
|
|
921
|
+
126. `list_environments` - List environments in a project
|
|
922
|
+
127. `get_environment` - Get details of a specific environment
|
|
923
|
+
128. `update_environment` - Update an environment
|
|
924
|
+
129. `delete_environment` - Delete a stopped environment
|
|
925
|
+
130. `stop_environment` - Stop an environment
|
|
926
|
+
131. `stop_stale_environments` - Stop eligible stale environments; protected environments are excluded and environments are stopped, not deleted
|
|
927
|
+
132. `delete_review_app_environments` - Schedule deletion of stopped review-app environments one week later; dry_run defaults to true and actual scheduling requires dry_run=false
|
|
928
|
+
133. `list_pipeline_triggers` - List project pipeline trigger tokens
|
|
929
|
+
134. `get_pipeline_trigger` - Get a project pipeline trigger
|
|
930
|
+
135. `create_pipeline_trigger` - Create a project pipeline trigger
|
|
931
|
+
136. `update_pipeline_trigger` - Update a project pipeline trigger
|
|
932
|
+
137. `delete_pipeline_trigger` - Delete a project pipeline trigger
|
|
933
|
+
138. `trigger_pipeline` - Trigger a pipeline with a pipeline trigger token
|
|
934
|
+
139. `list_pipeline_jobs` - List all jobs in a specific pipeline
|
|
935
|
+
140. `list_pipeline_trigger_jobs` - List trigger jobs (bridges) in a pipeline
|
|
936
|
+
141. `get_pipeline_job` - Get details of a GitLab pipeline job number
|
|
937
|
+
142. `get_pipeline_job_output` - Get a pipeline job trace, with end-based pagination or full-log substring/regex search
|
|
938
|
+
143. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
|
|
939
|
+
144. `validate_project_ci_lint` - Validate an existing .gitlab-ci.yml configuration for a project
|
|
940
|
+
145. `list_ci_catalog_resources` - List GitLab CI/CD Catalog resources/components visible to the user
|
|
941
|
+
146. `get_ci_catalog_resource` - Get details for a GitLab CI/CD Catalog resource, including versions and components
|
|
942
|
+
147. `create_pipeline` - Create a new pipeline for a branch or tag
|
|
943
|
+
148. `retry_pipeline` - Retry a failed or canceled pipeline
|
|
944
|
+
149. `cancel_pipeline` - Cancel a running pipeline
|
|
945
|
+
150. `list_pipeline_schedules` - List pipeline schedules in a project, optionally filtered to active or inactive
|
|
946
|
+
151. `get_pipeline_schedule` - Get details of a specific pipeline schedule, including its variables and last pipeline
|
|
947
|
+
152. `list_pipeline_schedule_pipelines` - List the pipelines that a pipeline schedule has triggered
|
|
948
|
+
153. `create_pipeline_schedule` - Create a new pipeline schedule for a branch or tag
|
|
949
|
+
154. `update_pipeline_schedule` - Update an existing pipeline schedule
|
|
950
|
+
155. `delete_pipeline_schedule` - Delete a pipeline schedule
|
|
951
|
+
156. `play_pipeline_schedule` - Run a pipeline schedule immediately
|
|
952
|
+
157. `take_ownership_pipeline_schedule` - Take ownership of a pipeline schedule
|
|
953
|
+
158. `get_pipeline_schedule_variable` - Get a single variable of a pipeline schedule
|
|
954
|
+
159. `create_pipeline_schedule_variable` - Create a variable for a pipeline schedule
|
|
955
|
+
160. `update_pipeline_schedule_variable` - Update a variable of a pipeline schedule
|
|
956
|
+
161. `delete_pipeline_schedule_variable` - Delete a variable from a pipeline schedule
|
|
957
|
+
162. `play_pipeline_job` - Run a manual pipeline job
|
|
958
|
+
163. `play_pipeline_jobs` - Play multiple manual pipeline jobs sequentially
|
|
959
|
+
164. `retry_pipeline_job` - Retry a failed or canceled pipeline job
|
|
960
|
+
165. `cancel_pipeline_job` - Cancel a running pipeline job
|
|
961
|
+
166. `erase_pipeline_job` - Erase a pipeline job log and artifacts
|
|
962
|
+
167. `wait_for_pipeline` - Wait for a pipeline to reach a terminal status
|
|
963
|
+
168. `wait_for_job` - Wait for a job to reach a terminal status
|
|
964
|
+
169. `list_job_artifacts` - List artifact files in a job's archive
|
|
965
|
+
170. `download_job_artifacts` - Download job artifact archive (zip) and save it under the download directory
|
|
966
|
+
171. `get_job_artifact_file` - Get content of a single file from a job's artifacts
|
|
967
|
+
172. `list_merge_requests` - List merge requests (without project_id: user's MRs; with project_id: project MRs)
|
|
968
|
+
173. `list_group_merge_requests` - List merge requests across all projects of a group and its subgroups
|
|
969
|
+
174. `list_milestones` - List milestones with filtering options
|
|
970
|
+
175. `get_milestone` - Get details of a specific milestone
|
|
971
|
+
176. `create_milestone` - Create a new milestone
|
|
972
|
+
177. `edit_milestone` - Edit an existing milestone
|
|
973
|
+
178. `delete_milestone` - Delete a milestone
|
|
974
|
+
179. `get_milestone_issue` - Get issues associated with a specific milestone
|
|
975
|
+
180. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
|
|
976
|
+
181. `promote_milestone` - Promote a milestone to the next stage
|
|
977
|
+
182. `get_milestone_burndown_events` - Get burndown events for a specific milestone
|
|
978
|
+
183. `list_group_milestones` - List group milestones with filtering options
|
|
979
|
+
184. `get_group_milestone` - Get details of a specific group milestone
|
|
980
|
+
185. `create_group_milestone` - Create a new group milestone
|
|
981
|
+
186. `edit_group_milestone` - Edit an existing group milestone
|
|
982
|
+
187. `delete_group_milestone` - Delete a group milestone
|
|
983
|
+
188. `get_group_milestone_issue` - Get issues associated with a specific group milestone
|
|
984
|
+
189. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
|
|
985
|
+
190. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
|
|
986
|
+
191. `get_users` - Get GitLab user details by usernames
|
|
987
|
+
192. `get_user` - Get user details by ID
|
|
988
|
+
193. `whoami` - Get current authenticated user details
|
|
989
|
+
194. `list_commits` - List repository commits with filtering options
|
|
990
|
+
195. `get_commit` - Get details of a specific commit
|
|
991
|
+
196. `get_commit_diff` - Get changes/diffs of a specific commit
|
|
992
|
+
197. `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.
|
|
993
|
+
198. `list_commit_statuses` - List statuses for a commit
|
|
994
|
+
199. `create_commit_status` - Create or update the status of a commit
|
|
995
|
+
200. `list_group_iterations` - List group iterations with filtering options
|
|
996
|
+
201. `get_group_iteration` - Get a group iteration by ID, IID, or GraphQL GID
|
|
997
|
+
202. `update_group_iteration` - Update a manual group iteration's title, description, or dates
|
|
998
|
+
203. `create_group_iteration` - Create a group iteration, optionally in a given iteration cadence
|
|
999
|
+
204. `delete_group_iteration` - Delete a group iteration by ID, IID, or GraphQL GID
|
|
1000
|
+
205. `list_project_iterations` - List the iterations available to a project with filtering options
|
|
1001
|
+
206. `list_group_iteration_cadences` - List a group's iteration cadences with filtering options
|
|
1002
|
+
207. `create_group_iteration_cadence` - Create an iteration cadence in a group
|
|
1003
|
+
208. `update_group_iteration_cadence` - Update an iteration cadence's title, description, schedule, or automation
|
|
1004
|
+
209. `delete_group_iteration_cadence` - Delete an iteration cadence
|
|
1005
|
+
210. `upload_markdown` - Upload a file for use in markdown content
|
|
1006
|
+
211. `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)
|
|
1007
|
+
212. `health_check` - Check auth and versions. Always includes mcp_server_version. When authenticated, also GitLab version, revision, and enterprise from GET /api/v4/version. Version lookup failures omit those fields instead of failing
|
|
1008
|
+
213. `list_events` - List events for the authenticated user (before/after: YYYY-MM-DD)
|
|
1009
|
+
214. `get_project_events` - List events for a project (before/after: YYYY-MM-DD)
|
|
1010
|
+
215. `list_releases` - List all releases for a project
|
|
1011
|
+
216. `get_release` - Get a release by tag name
|
|
1012
|
+
217. `create_release` - Create a new release
|
|
1013
|
+
218. `update_release` - Update an existing release
|
|
1014
|
+
219. `delete_release` - Delete a release (does not delete the tag)
|
|
1015
|
+
220. `create_release_evidence` - Create release evidence (Premium/Ultimate)
|
|
1016
|
+
221. `download_release_asset` - Download a release asset file by direct asset path
|
|
1017
|
+
222. `list_tags` - List repository tags for a project
|
|
1018
|
+
223. `get_tag` - Get a repository tag by name
|
|
1019
|
+
224. `create_tag` - Create a new repository tag
|
|
1020
|
+
225. `delete_tag` - Delete a repository tag
|
|
1021
|
+
226. `get_tag_signature` - Get the X.509 signature of a signed tag (404 if unsigned)
|
|
1022
|
+
227. `list_protected_tags` - List protected tags in a project
|
|
1023
|
+
228. `get_protected_tag` - Get details of a single protected tag or wildcard (create access levels)
|
|
1024
|
+
229. `protect_tag` - Protect a repository tag or wildcard (set who can create it)
|
|
1025
|
+
230. `unprotect_tag` - Remove protection from a previously protected tag or wildcard
|
|
1026
|
+
231. `get_work_item` - Get a work item with full details including status, hierarchy, type, and widgets
|
|
1027
|
+
232. `list_work_items` - List work items with filters (type, state, search, assignees, labels)
|
|
1028
|
+
233. `create_work_item` - Create a work item (issue, task, incident, epic, etc.) with full field support
|
|
1029
|
+
234. `update_work_item` - Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)
|
|
1030
|
+
235. `convert_work_item_type` - Convert a work item to a different type
|
|
1031
|
+
236. `list_work_item_statuses` - List available statuses for a work item type (Premium/Ultimate)
|
|
1032
|
+
237. `list_custom_field_definitions` - List custom field definitions for a work item type
|
|
1033
|
+
238. `move_work_item` - Move a work item to a different project
|
|
1034
|
+
239. `list_work_item_notes` - List notes and discussions on a work item
|
|
1035
|
+
240. `create_work_item_note` - Add a note to a work item (supports Markdown, internal notes, threads)
|
|
1036
|
+
241. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
|
|
1037
|
+
242. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
|
|
1038
|
+
243. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
|
|
1039
|
+
244. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
|
|
1040
|
+
245. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
|
|
1041
|
+
246. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
|
|
1042
|
+
247. `get_timeline_events` - List timeline events for an incident
|
|
1043
|
+
248. `create_timeline_event` - Create a timeline event on an incident
|
|
1044
|
+
249. `list_webhooks` - List webhooks for a project or group
|
|
1045
|
+
250. `create_webhook` - Create a webhook on a project or group
|
|
1046
|
+
251. `update_webhook` - Update an existing project or group webhook
|
|
1047
|
+
252. `delete_webhook` - Delete a project or group webhook
|
|
1048
|
+
253. `list_webhook_events` - List recent webhook events (past 7 days)
|
|
1049
|
+
254. `get_webhook_event` - Get full details of a specific webhook event
|
|
1050
|
+
255. `search_code` - Search for code across all projects (requires advanced search or Zoekt)
|
|
1051
|
+
256. `search_project_code` - Search for code within a specific project (requires advanced search or Zoekt)
|
|
1052
|
+
257. `search_group_code` - Search for code within a specific group (requires advanced search or Zoekt)
|
|
1053
|
+
258. `list_project_variables` - List CI/CD variables for a project
|
|
1054
|
+
259. `get_project_variable` - Get a single CI/CD variable from a project
|
|
1055
|
+
260. `create_project_variable` - Create a CI/CD variable for a project
|
|
1056
|
+
261. `update_project_variable` - Update an existing CI/CD variable in a project
|
|
1057
|
+
262. `delete_project_variable` - Delete a CI/CD variable from a project
|
|
1058
|
+
263. `list_group_variables` - List CI/CD variables for a group
|
|
1059
|
+
264. `get_group_variable` - Get a single CI/CD variable from a group
|
|
1060
|
+
265. `create_group_variable` - Create a CI/CD variable for a group
|
|
1061
|
+
266. `update_group_variable` - Update an existing CI/CD variable in a group
|
|
1062
|
+
267. `delete_group_variable` - Delete a CI/CD variable from a group
|
|
1063
|
+
268. `get_dependency_proxy_settings` - Get dependency proxy settings for a group
|
|
1064
|
+
269. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
|
|
1065
|
+
270. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group
|
|
1066
|
+
271. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
|
|
1067
|
+
272. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
|
|
1068
|
+
273. `get_vulnerability` - Get full details of a specific vulnerability
|
|
1069
|
+
274. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
|
|
1070
|
+
275. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
|
|
1071
|
+
276. `orbit_query` - Execute a GitLab Orbit graph query over the indexed SDLC knowledge graph
|
|
1072
|
+
277. `orbit_get_schema` - Fetch the current GitLab Orbit graph schema (node and edge types)
|
|
1073
|
+
278. `orbit_get_status` - Check GitLab Orbit indexing status for the enabled scope
|
|
1074
|
+
279. `orbit_list_tools` - List the MCP tool definitions exposed by GitLab Orbit
|
|
1075
|
+
280. `list_snippets` - List snippets — project snippets when project_id is given, otherwise personal snippets
|
|
1076
|
+
281. `get_snippet` - Get a snippet's metadata. Set include_content=true to also fetch the raw file content.
|
|
1077
|
+
282. `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.
|
|
1078
|
+
283. `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.
|
|
1079
|
+
284. `delete_snippet` - Delete a snippet
|
|
1080
|
+
285. `list_project_runners` - List runners available to a project (type, status, paused, tag_list). Omits registration and authentication tokens.
|
|
1081
|
+
286. `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.
|
|
1082
|
+
287. `rebase_merge_request` - Rebase the source branch of a merge request onto its target branch
|
|
1083
|
+
288. `gitlab_api_request` - Send one GitLab REST call under /api/v4. Enabled only when GITLAB_TOOLSETS lists api. Readonly allows GET; modify rejects DELETE.
|
|
1084
|
+
289. `discover_tools` - List or activate a toolset for this session. Omit category to list; pass one to enable. Prefer this over GITLAB_TOOLSETS=all (loads ~all schemas). Session-only; with OAUTH_STATELESS_MODE=true persist GITLAB_TOOLSETS.
|
|
1085
|
+
290. `help` - Return a short GitLab workflow guide. Omit topic for the overview and topic list.
|
|
1084
1086
|
|
|
1085
1087
|
<!-- TOOLS-END -->
|
|
1086
1088
|
|
package/README.pt-BR.md
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
|
|
15
15
|
📖 **[Documentação →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
|
|
16
16
|
|
|
17
|
-
**Padrão: 40 ferramentas** (38 `core` + `discover_tools` + `help`). Existem
|
|
17
|
+
**Padrão: 40 ferramentas** (38 `core` + `discover_tools` + `help`). Existem 290 no total (287 em toolsets + `execute_graphql` + `discover_tools` + `help`). Comece enxuto; chame `discover_tools` para ativar mais nesta sessão.
|
|
18
18
|
|
|
19
19
|
> **Orçamento de tokens:** clientes MCP enviam o `tools/list` inteiro ao modelo no início da sessão. Mantenha o padrão (~40 ferramentas, ~12k tokens de schema). Chame `discover_tools` para ativar uma categoria nesta sessão (somente nesta sessão; com `OAUTH_STATELESS_MODE=true` persista uma lista `GITLAB_TOOLSETS`), ou use [Skill + CLI](./docs/getting-started/cli-without-mcp.md) e pule os schemas MCP. **Não defina `GITLAB_TOOLSETS=all`** — carrega quase todas as ferramentas e custa ~73k tokens de schema. Veja [tamanho do tools/list](#tamanho-do-toolslist-medido-em-2026-11-14) e [comparação](./docs/comparison/index.md).
|
|
20
20
|
|
|
@@ -148,7 +148,7 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinâmicas e autorização
|
|
|
148
148
|
|
|
149
149
|
### Por que usar este GitLab MCP?
|
|
150
150
|
|
|
151
|
-
- **40 ferramentas por padrão (38 `core` + `discover_tools` + `help`);
|
|
151
|
+
- **40 ferramentas por padrão (38 `core` + `discover_tools` + `help`); 290 no total** — comece enxuto; chame `discover_tools` para expandir nesta sessão. `GITLAB_TOOLSETS=all` custa ~73k tokens de schema; prefira descoberta sob demanda ou Skill + CLI
|
|
152
152
|
- **Revisão de MR em 2 etapas** — `list_merge_request_changed_files` → `get_merge_request_file_diff` em lote
|
|
153
153
|
- **Agent Skill integrado** — orientação de workflows em `skills/gitlab-mcp/`
|
|
154
154
|
- **Autenticação flexível** — Personal Access Token, fluxo OAuth2 local no navegador, proxy MCP OAuth e autorização remota por requisição
|
|
@@ -162,7 +162,7 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinâmicas e autorização
|
|
|
162
162
|
| | @zereight/mcp-gitlab | GitLab MCP A (comunidade, estilo CQRS) | Servidor MCP oficial do GitLab |
|
|
163
163
|
| ------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
164
164
|
| **Mais indicado para** | Workflows de agentes de IA | Múltiplas instâncias corporativas / ferramentas agrupadas | Integrado ao GitLab, sem instalação separada |
|
|
165
|
-
| **Modelo de ferramentas** |
|
|
165
|
+
| **Modelo de ferramentas** | 290 ferramentas: 287 em toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 ferramentas agrupadas `browse_*` / `manage_*` | Toolsets escolhidos por cabeçalho HTTP |
|
|
166
166
|
| **Revisão de MR** | Diff em lote em 2 etapas | Varia | `get_merge_request` com diffs |
|
|
167
167
|
| **Node.js** | >=20.0.0 | Frequentemente >=24 | Node.js 20+ para stdio via `mcp-remote` |
|
|
168
168
|
| **Licença** | MIT | Varia | Parte do GitLab |
|