gitlab-mcp 1.2.1 → 1.3.0

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.
Files changed (40) hide show
  1. package/README.md +30 -27
  2. package/dist/config/dotenv.js +6 -2
  3. package/dist/config/dotenv.js.map +1 -1
  4. package/dist/config/env.d.ts +3 -1
  5. package/dist/config/env.js +15 -1
  6. package/dist/config/env.js.map +1 -1
  7. package/dist/http-app.js +10 -3
  8. package/dist/http-app.js.map +1 -1
  9. package/dist/http.js +5 -4
  10. package/dist/http.js.map +1 -1
  11. package/dist/index.js +5 -4
  12. package/dist/index.js.map +1 -1
  13. package/dist/lib/auth-context.d.ts +2 -1
  14. package/dist/lib/auth-context.js.map +1 -1
  15. package/dist/lib/gitlab-client.d.ts +42 -8
  16. package/dist/lib/gitlab-client.js +380 -42
  17. package/dist/lib/gitlab-client.js.map +1 -1
  18. package/dist/lib/network.js +12 -6
  19. package/dist/lib/network.js.map +1 -1
  20. package/dist/lib/oauth-scopes.d.ts +2 -0
  21. package/dist/lib/oauth-scopes.js +16 -0
  22. package/dist/lib/oauth-scopes.js.map +1 -0
  23. package/dist/lib/regex.d.ts +5 -0
  24. package/dist/lib/regex.js +111 -0
  25. package/dist/lib/regex.js.map +1 -0
  26. package/dist/lib/request-runtime.js +24 -11
  27. package/dist/lib/request-runtime.js.map +1 -1
  28. package/dist/tools/gitlab.js +193 -3
  29. package/dist/tools/gitlab.js.map +1 -1
  30. package/dist/types/auth.d.ts +1 -0
  31. package/dist/types/auth.js +2 -0
  32. package/dist/types/auth.js.map +1 -0
  33. package/dist/types/context.d.ts +1 -0
  34. package/docs/architecture.md +1 -1
  35. package/docs/authentication.md +4 -1
  36. package/docs/configuration.md +23 -21
  37. package/docs/deployment.md +2 -0
  38. package/docs/mcp-integration-testing-best-practices.md +381 -730
  39. package/docs/tools.md +24 -14
  40. package/package.json +1 -1
package/docs/tools.md CHANGED
@@ -88,6 +88,7 @@ Most list endpoints support `page` and `per_page`. Notable exceptions are `gitla
88
88
  | `gitlab_list_merge_request_diffs` | No | List detailed MR diffs (versions/changes view). Supports `unidiff`. |
89
89
  | `gitlab_list_merge_request_versions` | No | List MR diff versions. |
90
90
  | `gitlab_get_merge_request_version` | No | Get one MR diff version. Params: `version_id` (required), `unidiff`. |
91
+ | `gitlab_get_merge_request_conflicts` | No | Get merge request conflict details from GitLab's conflicts endpoint. |
91
92
 
92
93
  ### MR Code Context
93
94
 
@@ -208,20 +209,29 @@ Requires `USE_GITLAB_WIKI=true` (default).
208
209
 
209
210
  Requires `USE_PIPELINE=true` (default).
210
211
 
211
- | Tool | Mutating | Description |
212
- | ----------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
213
- | `gitlab_list_pipelines` | No | List pipelines. Supports `scope`, `status`, `ref`, `sha`, `username`, `source`, `order_by`, `sort`, date filters. |
214
- | `gitlab_get_pipeline` | No | Get one pipeline by ID. |
215
- | `gitlab_list_pipeline_jobs` | No | List jobs in a pipeline. Supports `scope`, `include_retried`. |
216
- | `gitlab_list_pipeline_trigger_jobs` | No | List downstream/bridge trigger jobs in a pipeline. |
217
- | `gitlab_get_pipeline_job` | No | Get one job by ID. |
218
- | `gitlab_get_pipeline_job_output` | No | Get raw job trace/log output. |
219
- | `gitlab_create_pipeline` | **Yes** | Trigger a new pipeline. Params: `ref` (required). Supports `variables` array (`key`, `value`, `variable_type`). |
220
- | `gitlab_retry_pipeline` | **Yes** | Retry failed jobs in a pipeline. |
221
- | `gitlab_cancel_pipeline` | **Yes** | Cancel a running pipeline. |
222
- | `gitlab_retry_pipeline_job` | **Yes** | Retry one failed job. |
223
- | `gitlab_cancel_pipeline_job` | **Yes** | Cancel one running job. |
224
- | `gitlab_play_pipeline_job` | **Yes** | Play/trigger a manual job. |
212
+ | Tool | Mutating | Description |
213
+ | ------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
214
+ | `gitlab_list_pipelines` | No | List pipelines. Supports `scope`, `status`, `ref`, `sha`, `username`, `source`, `order_by`, `sort`, date filters. |
215
+ | `gitlab_get_pipeline` | No | Get one pipeline by ID. |
216
+ | `gitlab_list_deployments` | No | List deployments. Supports `environment`, `ref`, `sha`, `status`, `order_by`, `sort`, date filters. |
217
+ | `gitlab_get_deployment` | No | Get one deployment by ID. |
218
+ | `gitlab_list_environments` | No | List environments. Supports `name`, `search`, `states`, pagination. |
219
+ | `gitlab_get_environment` | No | Get one environment by ID. |
220
+ | `gitlab_list_pipeline_jobs` | No | List jobs in a pipeline. Supports `scope`, `include_retried`. |
221
+ | `gitlab_list_pipeline_trigger_jobs` | No | List downstream/bridge trigger jobs in a pipeline. |
222
+ | `gitlab_get_pipeline_job` | No | Get one job by ID. |
223
+ | `gitlab_get_pipeline_job_output` | No | Get raw job trace/log output. |
224
+ | `gitlab_list_job_artifacts` | No | List files and directories inside a job artifacts archive. Supports `path`, `recursive`. |
225
+ | `gitlab_download_job_artifacts` | No | Download the full artifacts archive as base64 content. |
226
+ | `gitlab_download_job_artifacts_local` | **Yes** | Download the full artifacts archive to a local directory. Supports `local_path`. Available only on local transports; not exposed over HTTP. |
227
+ | `gitlab_get_job_artifact_file` | No | Return one file from a job artifacts archive as inline content. Text-like files are UTF-8; binary files are base64. |
228
+ | `gitlab_get_job_artifact_file_local` | **Yes** | Save one file from a job artifacts archive to a local directory. Supports `local_path`. Available only on local transports; not exposed over HTTP. |
229
+ | `gitlab_create_pipeline` | **Yes** | Trigger a new pipeline. Params: `ref` (required). Supports `variables` array (`key`, `value`, `variable_type`) and typed `inputs` for `spec:inputs` (`string`, `number`, `boolean`, arrays). |
230
+ | `gitlab_retry_pipeline` | **Yes** | Retry failed jobs in a pipeline. |
231
+ | `gitlab_cancel_pipeline` | **Yes** | Cancel a running pipeline. |
232
+ | `gitlab_retry_pipeline_job` | **Yes** | Retry one failed job. |
233
+ | `gitlab_cancel_pipeline_job` | **Yes** | Cancel one running job. |
234
+ | `gitlab_play_pipeline_job` | **Yes** | Play/trigger a manual job. |
225
235
 
226
236
  ---
227
237
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gitlab-mcp",
3
- "version": "1.2.1",
3
+ "version": "1.3.0",
4
4
  "description": "A MCP server for GitLab",
5
5
  "type": "module",
6
6
  "bin": {