@zereight/mcp-gitlab 2.3.28 โ 2.3.29-next.248
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/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 |
|
package/README.zh-CN.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 ไธชๅทฅๅ
ท**๏ผ38 ไธช `core` + `discover_tools` + `help`๏ผใๆปๅ
ฑ
|
|
17
|
+
**้ป่ฎคๆด้ฒ 40 ไธชๅทฅๅ
ท**๏ผ38 ไธช `core` + `discover_tools` + `help`๏ผใๆปๅ
ฑ 290 ไธช๏ผtoolset ไธญ 287 ไธช + `execute_graphql` + `discover_tools` + `help`๏ผใๅ
็จ็ฒพ็ฎ้๏ผๅๅจๆฌไผ่ฏไธญ็จ `discover_tools` ๆฉๅฑใ
|
|
18
18
|
|
|
19
19
|
> **Token ้ข็ฎ๏ผ** MCP ๅฎขๆท็ซฏไผๅจไผ่ฏๅผๅงๆถๆๆดไปฝ `tools/list` ๅ็ปๆจกๅใ่ฏทไฟๆ้ป่ฎค๏ผ็บฆ 40 ไธชๅทฅๅ
ท๏ผ็บฆ 12k schema token๏ผใ็จ `discover_tools` ไธบๆฌไผ่ฏๆฟๆดป็ฑปๅซ๏ผไป
้ๆฌไผ่ฏ๏ผ`OAUTH_STATELESS_MODE=true` ๆถ่ฏทๆน็จๅฝๅ็ `GITLAB_TOOLSETS`๏ผ๏ผๆ่ตฐ [Skill + CLI](./docs/getting-started/cli-without-mcp.md) ไปฅ่ทณ่ฟ MCP schemaใ**ไธ่ฆ่ฎพ็ฝฎ `GITLAB_TOOLSETS=all`** โ ๅฎไผๅ ่ฝฝๅ ไนๅ
จ้จๅทฅๅ
ท๏ผschema ็บฆ 73k tokenใ่ง [tools/list ไฝ็งฏ](#toolslist-ไฝ็งฏ2026-11-14-ๅฎๆต) ๅ [ๅฏนๆฏ](./docs/comparison/index.md)ใ
|
|
20
20
|
|
|
@@ -148,7 +148,7 @@ GitLab ๅๅนถ่ฏทๆฑใ่ฎฎ้ขๅๆตๆฐด็บฟ่ตฐๆญค MCP๏ผ@zereight/mcp-gitlab๏ผใ
|
|
|
148
148
|
|
|
149
149
|
### ไธบไปไนไฝฟ็จ่ฟไธช GitLab MCP๏ผ
|
|
150
150
|
|
|
151
|
-
- **้ป่ฎค 40 ไธชๅทฅๅ
ท๏ผ38 ไธช `core` + `discover_tools` + `help`๏ผ๏ผๅ
ฑ
|
|
151
|
+
- **้ป่ฎค 40 ไธชๅทฅๅ
ท๏ผ38 ไธช `core` + `discover_tools` + `help`๏ผ๏ผๅ
ฑ 290 ไธช** โ ๅ
็ฒพ็ฎ๏ผๅ็จ `discover_tools` ๅจๆฌไผ่ฏๆฉๅฑใ`GITLAB_TOOLSETS=all` ็บฆ 73k schema token๏ผๆ้ๅ็ฐๆไฝฟ็จ Skill + CLI
|
|
152
152
|
- **MR ไธคๆญฅๅฎกๆฅ** โ `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 @@ GitLab ๅๅนถ่ฏทๆฑใ่ฎฎ้ขๅๆตๆฐด็บฟ่ตฐๆญค MCP๏ผ@zereight/mcp-gitlab๏ผใ
|
|
|
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 ๅฎกๆฅ** | ไธคๆญฅๆน้ diff | ๅ ๆๅกๅจ่ๅผ | `get_merge_request` ๅธฆ diffs |
|
|
167
167
|
| **Node.js** | >=20.0.0 | ้ๅธธ >=24 | stdio ็ป `mcp-remote`๏ผ้่ฆ Node.js 20+ |
|
|
168
168
|
| **่ฎธๅฏ่ฏ** | MIT | ๅ ๆๅกๅจ่ๅผ | GitLab ็ไธ้จๅ |
|
package/build/index.js
CHANGED
|
@@ -147,7 +147,7 @@ import { BulkPublishDraftNotesSchema, CancelPipelineJobSchema, ErasePipelineJobS
|
|
|
147
147
|
GitLabDiscussionNoteSchema, // Added
|
|
148
148
|
GitLabDiscussionSchema,
|
|
149
149
|
// Draft Notes Schemas
|
|
150
|
-
GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabProtectedBranchSchema, GitLabGroupSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabDeploymentSchema, GitLabEnvironmentSchema, GitLabPipelineSchema, GitLabPipelineScheduleSchema, GitLabPipelineScheduleVariableSchema, GitLabPipelineSchedulePlayResultSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabTodoSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchBlobResultSchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabUserSchema, GitLabUsersResponseSchema, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, GroupIterationCadence, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupProjectsSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListTodosSchema, ListMergeRequestDiffsSchema, // Added
|
|
150
|
+
GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabProtectedBranchSchema, GitLabGroupSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabResourceLabelEventSchema, GitLabResourceStateEventSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabDeploymentSchema, GitLabEnvironmentSchema, GitLabPipelineSchema, GitLabPipelineScheduleSchema, GitLabPipelineScheduleVariableSchema, GitLabPipelineSchedulePlayResultSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabTodoSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchBlobResultSchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabUserSchema, GitLabUsersResponseSchema, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, GroupIterationCadence, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupProjectsSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssueLabelEventsSchema, ListIssueStateEventsSchema, ListIssuesSchema, ListTodosSchema, ListMergeRequestDiffsSchema, // Added
|
|
151
151
|
GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListProjectRunnersSchema, GetRunnerSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListProjectMembersSchema, ListGroupMembersSchema, ListProjectsSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, ReorderIssueSchema, UpdateProjectSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, GitLabSnippetSchema, GetMergeRequestNotesSchema, GetMergeRequestNoteSchema, GetMergeRequestDiscussionSchema, DeleteMergeRequestDiscussionNoteSchema, ResolveMergeRequestThreadSchema, GetWorkItemSchema, ListWorkItemsSchema, CreateWorkItemSchema, UpdateWorkItemSchema, ConvertWorkItemTypeSchema, ListWorkItemStatusesSchema, ListWorkItemNotesSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, MoveWorkItemSchema, ListCustomFieldDefinitionsSchema, GetTimelineEventsSchema, CreateTimelineEventSchema, ListWebhooksSchema, CreateWebhookSchema, UpdateWebhookSchema, DeleteWebhookSchema, ListWebhookEventsSchema, GetWebhookEventSchema, HealthCheckSchema, } from "./schemas.js";
|
|
152
152
|
import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
|
|
153
153
|
import { createGraphQLAuditFailure, createToolCallAuditor, graphqlPayloadHasErrors, markToolResultAsAuditFailure, readKnownGitLabUserId, readKnownGitLabUsername, } from "./utils/audit-log.js";
|
|
@@ -3337,6 +3337,63 @@ async function listIssueLinks(projectId, issueIid) {
|
|
|
3337
3337
|
const data = await response.json();
|
|
3338
3338
|
return z.array(GitLabIssueWithLinkDetailsSchema).parse(data);
|
|
3339
3339
|
}
|
|
3340
|
+
/** Reduce an event's author to `{ username }`; null for ghost or system events. */
|
|
3341
|
+
function toLeanEventUser(user) {
|
|
3342
|
+
return user ? { username: user.username } : null;
|
|
3343
|
+
}
|
|
3344
|
+
/** Map a GitLab resource label event to the lean shape; label is null when it was deleted. */
|
|
3345
|
+
function toLeanLabelEvent(event) {
|
|
3346
|
+
return {
|
|
3347
|
+
created_at: event.created_at,
|
|
3348
|
+
user: toLeanEventUser(event.user),
|
|
3349
|
+
action: event.action,
|
|
3350
|
+
label: event.label ? { name: event.label.name } : null,
|
|
3351
|
+
};
|
|
3352
|
+
}
|
|
3353
|
+
/** Map a GitLab resource state event to the lean shape. */
|
|
3354
|
+
function toLeanStateEvent(event) {
|
|
3355
|
+
return {
|
|
3356
|
+
created_at: event.created_at,
|
|
3357
|
+
user: toLeanEventUser(event.user),
|
|
3358
|
+
state: event.state,
|
|
3359
|
+
};
|
|
3360
|
+
}
|
|
3361
|
+
/**
|
|
3362
|
+
* Fetch one page of an issue's resource events (label or state) from GitLab.
|
|
3363
|
+
* Returns the raw JSON; callers parse and map it.
|
|
3364
|
+
*/
|
|
3365
|
+
async function fetchIssueResourceEvents(projectId, issueIid, resource, options) {
|
|
3366
|
+
projectId = decodeURIComponent(projectId);
|
|
3367
|
+
const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeGitLabPathSegment(getEffectiveProjectId(projectId))}/issues/${encodeGitLabPathSegment(issueIid)}/${resource}`);
|
|
3368
|
+
appendFilterParams(url.searchParams, options);
|
|
3369
|
+
const response = await fetch(url.toString(), {
|
|
3370
|
+
...getFetchConfig(),
|
|
3371
|
+
});
|
|
3372
|
+
await handleGitLabError(response);
|
|
3373
|
+
return response.json();
|
|
3374
|
+
}
|
|
3375
|
+
/**
|
|
3376
|
+
* List the label events of an issue (who added or removed which label, when)
|
|
3377
|
+
*
|
|
3378
|
+
* @param {string} projectId - The ID or URL-encoded path of the project
|
|
3379
|
+
* @param {number} issueIid - The internal ID of the project issue
|
|
3380
|
+
* @returns Lean label events in GitLab's order
|
|
3381
|
+
*/
|
|
3382
|
+
async function listIssueLabelEvents(projectId, issueIid, options = {}) {
|
|
3383
|
+
const data = await fetchIssueResourceEvents(projectId, issueIid, "resource_label_events", options);
|
|
3384
|
+
return z.array(GitLabResourceLabelEventSchema).parse(data).map(toLeanLabelEvent);
|
|
3385
|
+
}
|
|
3386
|
+
/**
|
|
3387
|
+
* List the state events of an issue (who closed or reopened it, when)
|
|
3388
|
+
*
|
|
3389
|
+
* @param {string} projectId - The ID or URL-encoded path of the project
|
|
3390
|
+
* @param {number} issueIid - The internal ID of the project issue
|
|
3391
|
+
* @returns Lean state events in GitLab's order
|
|
3392
|
+
*/
|
|
3393
|
+
async function listIssueStateEvents(projectId, issueIid, options = {}) {
|
|
3394
|
+
const data = await fetchIssueResourceEvents(projectId, issueIid, "resource_state_events", options);
|
|
3395
|
+
return z.array(GitLabResourceStateEventSchema).parse(data).map(toLeanStateEvent);
|
|
3396
|
+
}
|
|
3340
3397
|
/**
|
|
3341
3398
|
* Get a specific issue link
|
|
3342
3399
|
* ํน์ ์ด์ ๊ด๊ณ ์กฐํ
|
|
@@ -8874,6 +8931,20 @@ async function handleToolCall(params) {
|
|
|
8874
8931
|
content: [{ type: "text", text: JSON.stringify(links) }],
|
|
8875
8932
|
};
|
|
8876
8933
|
}
|
|
8934
|
+
case "list_issue_label_events": {
|
|
8935
|
+
const { project_id, issue_iid, ...options } = ListIssueLabelEventsSchema.parse(params.arguments);
|
|
8936
|
+
const events = await listIssueLabelEvents(project_id, issue_iid, options);
|
|
8937
|
+
return {
|
|
8938
|
+
content: [{ type: "text", text: JSON.stringify(events) }],
|
|
8939
|
+
};
|
|
8940
|
+
}
|
|
8941
|
+
case "list_issue_state_events": {
|
|
8942
|
+
const { project_id, issue_iid, ...options } = ListIssueStateEventsSchema.parse(params.arguments);
|
|
8943
|
+
const events = await listIssueStateEvents(project_id, issue_iid, options);
|
|
8944
|
+
return {
|
|
8945
|
+
content: [{ type: "text", text: JSON.stringify(events) }],
|
|
8946
|
+
};
|
|
8947
|
+
}
|
|
8877
8948
|
case "list_issue_discussions": {
|
|
8878
8949
|
const args = ListIssueDiscussionsSchema.parse(params.arguments);
|
|
8879
8950
|
const { project_id, issue_iid, ...options } = args;
|
package/build/schemas.js
CHANGED
|
@@ -4661,6 +4661,25 @@ export const ListWorkItemNoteEmojiReactionsSchema = z.object({
|
|
|
4661
4661
|
.string()
|
|
4662
4662
|
.describe("The GraphQL GID of the note (e.g. 'gid://gitlab/Note/123' from list_work_item_notes)"),
|
|
4663
4663
|
});
|
|
4664
|
+
// --- Resource event schemas (issue label and state history) ---
|
|
4665
|
+
// See https://docs.gitlab.com/api/resource_label_events/ and https://docs.gitlab.com/api/resource_state_events/
|
|
4666
|
+
export const ListIssueLabelEventsSchema = ProjectParamsSchema.extend({
|
|
4667
|
+
issue_iid: z.coerce.string().describe("The IID of an issue"),
|
|
4668
|
+
}).merge(PaginationOptionsSchema);
|
|
4669
|
+
export const ListIssueStateEventsSchema = ListIssueLabelEventsSchema;
|
|
4670
|
+
const GitLabResourceEventUserSchema = z.object({ username: z.string() }).nullable().optional();
|
|
4671
|
+
export const GitLabResourceLabelEventSchema = z.object({
|
|
4672
|
+
created_at: z.string(),
|
|
4673
|
+
action: z.string(), // "add" or "remove"
|
|
4674
|
+
user: GitLabResourceEventUserSchema,
|
|
4675
|
+
// GitLab returns null for a label that was deleted since the event.
|
|
4676
|
+
label: z.object({ name: z.string() }).nullable().optional(),
|
|
4677
|
+
});
|
|
4678
|
+
export const GitLabResourceStateEventSchema = z.object({
|
|
4679
|
+
created_at: z.string(),
|
|
4680
|
+
state: z.string(),
|
|
4681
|
+
user: GitLabResourceEventUserSchema,
|
|
4682
|
+
});
|
|
4664
4683
|
// --- Incident Timeline Event schemas ---
|
|
4665
4684
|
export const GetTimelineEventsSchema = z.object({
|
|
4666
4685
|
project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
|
package/build/server/mcp-help.js
CHANGED
|
@@ -51,6 +51,7 @@ const GUIDES = {
|
|
|
51
51
|
"Write: create_issue, update_issue, create_issue_note, list_issue_discussions.",
|
|
52
52
|
"Small description edits: update_issue_description_patch instead of resending the full body.",
|
|
53
53
|
"Board order: reorder_issue (move_after_id / move_before_id are global issue ids, not iids).",
|
|
54
|
+
"History: list_issue_label_events, list_issue_state_events (label-based board column flow).",
|
|
54
55
|
"project_id is a numeric ID or URL-encoded path.",
|
|
55
56
|
].join("\n"),
|
|
56
57
|
pipelines: [
|
package/build/tools/registry.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { lazyJSONSchema, withLazyInputSchemas } from "../utils/schema.js";
|
|
2
2
|
import { USE_GITLAB_WIKI, USE_MILESTONE, USE_PIPELINE, SSE, STREAMABLE_HTTP } from "../config.js";
|
|
3
3
|
import { getToolDescription } from "./tool-descriptions.js";
|
|
4
|
-
import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, ErasePipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateGroupSchema, CreateGroupWikiPageSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, MarkAllTodosDoneSchema, ListTodosSchema, MarkTodoDoneSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestNoteSchema, CreateMergeRequestNoteEmojiReactionSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateGroupMilestoneSchema, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWebhookSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteBranchSchema, GetProtectedBranchSchema, ListProtectedBranchesSchema, ProtectBranchSchema, UpdateProtectedBranchSchema, ProtectTagSchema, UnprotectBranchSchema, UnprotectTagSchema, UpdateDefaultBranchSchema, DeleteDraftNoteSchema, DeleteGroupMilestoneSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWebhookSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadAttachmentRemoteSchema, DownloadJobArtifactsSchema, DownloadJobArtifactsRemoteSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, EditGroupMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetFileBlameSchema, GetDeploymentSchema, CreateDeploymentSchema, UpdateDeploymentSchema, DeploymentApprovalSchema, ListDeploymentMergeRequestsSchema, GetDraftNoteSchema, GetEnvironmentSchema, UpdateEnvironmentSchema, StopEnvironmentSchema, StopStaleEnvironmentsSchema, DeleteReviewAppEnvironmentsSchema, PipelineTriggerIdSchema, ListPipelineTriggersSchema, CreatePipelineTriggerSchema, UpdatePipelineTriggerSchema, TriggerPipelineSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestDiscussionSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetGroupMilestoneSchema, GetGroupMilestoneIssuesSchema, GetGroupMilestoneMergeRequestsSchema, GetGroupMilestoneBurndownEventsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, PipelineJobControlSchema, GetPipelineSchema, GetRunnerSchema, GetPipelineVariablesSchema, UpdatePipelineMetadataSchema, DeletePipelineSchema, PipelineReportSchema, WaitForPipelineSchema, WaitForPipelineJobSchema, PlayPipelineJobsSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetProtectedTagSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListBranchesSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupMilestonesSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListPipelinesSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, ListGroupMembersSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListProjectRunnersSchema, ListReleasesSchema, ListTagsSchema, ListProtectedTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, ReorderIssueSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWebhookSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, } from "../schemas.js";
|
|
4
|
+
import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, ErasePipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateGroupSchema, CreateGroupWikiPageSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, MarkAllTodosDoneSchema, ListTodosSchema, MarkTodoDoneSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestNoteSchema, CreateMergeRequestNoteEmojiReactionSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateGroupMilestoneSchema, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWebhookSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteBranchSchema, GetProtectedBranchSchema, ListProtectedBranchesSchema, ProtectBranchSchema, UpdateProtectedBranchSchema, ProtectTagSchema, UnprotectBranchSchema, UnprotectTagSchema, UpdateDefaultBranchSchema, DeleteDraftNoteSchema, DeleteGroupMilestoneSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWebhookSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadAttachmentRemoteSchema, DownloadJobArtifactsSchema, DownloadJobArtifactsRemoteSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, EditGroupMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetFileBlameSchema, GetDeploymentSchema, CreateDeploymentSchema, UpdateDeploymentSchema, DeploymentApprovalSchema, ListDeploymentMergeRequestsSchema, GetDraftNoteSchema, GetEnvironmentSchema, UpdateEnvironmentSchema, StopEnvironmentSchema, StopStaleEnvironmentsSchema, DeleteReviewAppEnvironmentsSchema, PipelineTriggerIdSchema, ListPipelineTriggersSchema, CreatePipelineTriggerSchema, UpdatePipelineTriggerSchema, TriggerPipelineSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestDiscussionSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetGroupMilestoneSchema, GetGroupMilestoneIssuesSchema, GetGroupMilestoneMergeRequestsSchema, GetGroupMilestoneBurndownEventsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, PipelineJobControlSchema, GetPipelineSchema, GetRunnerSchema, GetPipelineVariablesSchema, UpdatePipelineMetadataSchema, DeletePipelineSchema, PipelineReportSchema, WaitForPipelineSchema, WaitForPipelineJobSchema, PlayPipelineJobsSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetProtectedTagSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListBranchesSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupMilestonesSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssueLabelEventsSchema, ListIssueStateEventsSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListPipelinesSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, ListGroupMembersSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListProjectRunnersSchema, ListReleasesSchema, ListTagsSchema, ListProtectedTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, ReorderIssueSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWebhookSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, } from "../schemas.js";
|
|
5
5
|
import { GitLabApiRequestSchema } from "./gitlab-api-request.js";
|
|
6
6
|
import { HelpInputSchema } from "../server/mcp-help.js";
|
|
7
7
|
const IS_REMOTE = SSE || STREAMABLE_HTTP;
|
|
@@ -414,6 +414,16 @@ export const allTools = withLazyInputSchemas([
|
|
|
414
414
|
description: "List discussions for an issue",
|
|
415
415
|
inputSchema: lazyJSONSchema(ListIssueDiscussionsSchema),
|
|
416
416
|
},
|
|
417
|
+
{
|
|
418
|
+
name: "list_issue_label_events",
|
|
419
|
+
description: "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.",
|
|
420
|
+
inputSchema: lazyJSONSchema(ListIssueLabelEventsSchema),
|
|
421
|
+
},
|
|
422
|
+
{
|
|
423
|
+
name: "list_issue_state_events",
|
|
424
|
+
description: "List an issue's state history: who closed or reopened it, when. Lean events: created_at, user.username, state. Paginated via page/per_page.",
|
|
425
|
+
inputSchema: lazyJSONSchema(ListIssueStateEventsSchema),
|
|
426
|
+
},
|
|
417
427
|
{
|
|
418
428
|
name: "get_issue_link",
|
|
419
429
|
description: "Get a specific issue link",
|
|
@@ -1522,6 +1532,8 @@ export const readOnlyTools = new Set([
|
|
|
1522
1532
|
"get_issue",
|
|
1523
1533
|
"list_issue_links",
|
|
1524
1534
|
"list_issue_discussions",
|
|
1535
|
+
"list_issue_label_events",
|
|
1536
|
+
"list_issue_state_events",
|
|
1525
1537
|
"get_issue_link",
|
|
1526
1538
|
"list_namespaces",
|
|
1527
1539
|
"get_namespace",
|
|
@@ -1964,6 +1976,8 @@ export const TOOLSET_DEFINITIONS = [
|
|
|
1964
1976
|
"update_issue_note",
|
|
1965
1977
|
"list_issue_links",
|
|
1966
1978
|
"list_issue_discussions",
|
|
1979
|
+
"list_issue_label_events",
|
|
1980
|
+
"list_issue_state_events",
|
|
1967
1981
|
"get_issue_link",
|
|
1968
1982
|
"create_issue_link",
|
|
1969
1983
|
"delete_issue_link",
|
|
@@ -28,7 +28,7 @@ const SUMMARY_FIELDS = [
|
|
|
28
28
|
];
|
|
29
29
|
/**
|
|
30
30
|
* Extra fields a tool's summary keeps on top of SUMMARY_FIELDS: the access and
|
|
31
|
-
* protection fields these tools exist to answer
|
|
31
|
+
* protection fields (#942) or the event fields these tools exist to answer.
|
|
32
32
|
*/
|
|
33
33
|
const TOOL_SUMMARY_FIELDS = {
|
|
34
34
|
list_branches: [
|
|
@@ -49,6 +49,8 @@ const TOOL_SUMMARY_FIELDS = {
|
|
|
49
49
|
list_protected_tags: ["create_access_levels"],
|
|
50
50
|
list_project_members: ["access_level", "expires_at"],
|
|
51
51
|
list_group_members: ["access_level", "expires_at"],
|
|
52
|
+
list_issue_label_events: ["created_at", "user", "action", "label"],
|
|
53
|
+
list_issue_state_events: ["created_at", "user"],
|
|
52
54
|
};
|
|
53
55
|
/** Fields kept per note when a summarized item carries discussion `notes`. */
|
|
54
56
|
const NOTE_SUMMARY_FIELDS = ["id", "body", "created_at", "resolved"];
|
|
@@ -70,11 +72,13 @@ const LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS = new Set([
|
|
|
70
72
|
"list_group_iterations", // start_date, due_date
|
|
71
73
|
"list_project_iterations", // start_date, due_date
|
|
72
74
|
"list_group_iteration_cadences", // start_date, duration_in_weeks, iterations_in_advance
|
|
73
|
-
// Small replies whose access fields are the point; summary: true keeps them (TOOL_SUMMARY_FIELDS).
|
|
75
|
+
// Small replies whose access or event fields are the point; summary: true keeps them (TOOL_SUMMARY_FIELDS).
|
|
74
76
|
"list_protected_branches", // *_access_levels, allow_force_push
|
|
75
77
|
"list_protected_tags", // create_access_levels
|
|
76
78
|
"list_project_members", // access_level, expires_at
|
|
77
79
|
"list_group_members", // access_level, expires_at
|
|
80
|
+
"list_issue_label_events", // created_at, user, action, label
|
|
81
|
+
"list_issue_state_events", // created_at, user, state
|
|
78
82
|
// The reply is an envelope summarizeListPayload does not read.
|
|
79
83
|
"list_project_vulnerabilities", // { vulnerabilities, pageInfo }
|
|
80
84
|
"list_dependency_proxy_blobs", // { blobs, pageInfo }
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zereight/mcp-gitlab",
|
|
3
|
-
"version": "2.3.
|
|
3
|
+
"version": "2.3.29-next.248",
|
|
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": [
|
|
@@ -57,7 +57,7 @@
|
|
|
57
57
|
"coverage:summary": "tsx scripts/code-coverage-summary.ts",
|
|
58
58
|
"test:stateless": "npm run build && node --import tsx/esm --test --experimental-test-isolation=none test/stateless/codec.test.ts test/stateless/client-id.test.ts test/stateless/callback-proxy.test.ts test/stateless/session-id.test.ts test/stateless/session-id-integration.test.ts test/stateless/config-ttl.test.ts test/stateless/consumed-proxy-code-cache.test.ts",
|
|
59
59
|
"test:mcp-oauth": "npm run build && node --import tsx/esm --test test/mcp-oauth-tests.ts",
|
|
60
|
-
"test:live": "node test/validate-api.js",
|
|
60
|
+
"test:live": "node test/validate-api.js && node --import tsx/esm --test test/live/issue-resource-events.test.ts",
|
|
61
61
|
"test:consumer-smoke": "bash scripts/consumer-install-smoke.sh",
|
|
62
62
|
"test:remote-auth": "npm run build && node --import tsx/esm --test --experimental-test-isolation=none test/remote-auth-simple-test.ts",
|
|
63
63
|
"test:schema": "tsx test/schema-tests.ts && tsx test/test-json-schema.ts && node --import tsx/esm --test --experimental-test-isolation=none --test-concurrency=1 test/*-schema.test.ts",
|