@zereight/mcp-gitlab 1.0.51 → 1.0.53

package/README.md

@@ -26,8 +26,9 @@ When using with the Claude App, you need to set up your API key and URLs directl
         "GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token",
         "GITLAB_API_URL": "your_gitlab_api_url",
         "GITLAB_READ_ONLY_MODE": "false",
-        "USE_GITLAB_WIKI": "false",
-        "USE_MILESTONE": "false"
+        "USE_GITLAB_WIKI": "false", // use wiki api?
+        "USE_MILESTONE": "false", // use milestone api?
+        "USE_PIPELINE": "false" // use pipeline api?
       }
     }
   }
@@ -55,6 +56,8 @@ When using with the Claude App, you need to set up your API key and URLs directl
         "USE_GITLAB_WIKI",
         "-e",
         "USE_MILESTONE",
+        "-e",
+        "USE_PIPELINE",
         "iwakitakuma/gitlab-mcp"
       ],
       "env": {
@@ -62,7 +65,8 @@ When using with the Claude App, you need to set up your API key and URLs directl
         "GITLAB_API_URL": "https://gitlab.com/api/v4", // Optional, for self-hosted GitLab
         "GITLAB_READ_ONLY_MODE": "false",
         "USE_GITLAB_WIKI": "true",
-        "USE_MILESTONE": "true"
+        "USE_MILESTONE": "true",
+        "USE_PIPELINE": "true"
       }
     }
   }
@@ -82,6 +86,7 @@ $ sh scripts/image_push.sh docker_user_name
 - `GITLAB_READ_ONLY_MODE`: When set to 'true', restricts the server to only expose read-only operations. Useful for enhanced security or when write access is not needed. Also useful for using with Cursor and it's 40 tool limit.
 - `USE_GITLAB_WIKI`: When set to 'true', enables the wiki-related tools (list_wiki_pages, get_wiki_page, create_wiki_page, update_wiki_page, delete_wiki_page). By default, wiki features are disabled.
 - `USE_MILESTONE`: When set to 'true', enables the milestone-related tools (list_milestones, get_milestone, create_milestone, edit_milestone, delete_milestone, get_milestone_issue, get_milestone_merge_requests, promote_milestone, get_milestone_burndown_events). By default, milestone features are disabled.
+- `USE_PIPELINE`: When set to 'true', enables the pipeline-related tools (list_pipelines, get_pipeline, list_pipeline_jobs, get_pipeline_job, get_pipeline_job_output, create_pipeline, retry_pipeline, cancel_pipeline). By default, pipeline features are disabled.
 
 ## Tools 🛠️
 
@@ -137,14 +142,17 @@ $ sh scripts/image_push.sh docker_user_name
 48. `list_pipeline_jobs` - List all jobs in a specific pipeline
 49. `get_pipeline_job` - Get details of a GitLab pipeline job number
 50. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job number
-51. `list_merge_requests` - List merge requests in a GitLab project with filtering options
-52. `list_milestones` - List milestones in a GitLab project with filtering options
-53. `get_milestone` - Get details of a specific milestone
-54. `create_milestone` - Create a new milestone in a GitLab project
-55. `edit_milestone ` - Edit an existing milestone in a GitLab project
-56. `delete_milestone` - Delete a milestone from a GitLab project
-57. `get_milestone_issue` - Get issues associated with a specific milestone
-58. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
-59. `promote_milestone` - Promote a milestone to the next stage
-60. `get_milestone_burndown_events` - Get burndown events for a specific milestone
+51. `create_pipeline` - Create a new pipeline for a branch or tag
+52. `retry_pipeline` - Retry a failed or canceled pipeline
+53. `cancel_pipeline` - Cancel a running pipeline
+54. `list_merge_requests` - List merge requests in a GitLab project with filtering options
+55. `list_milestones` - List milestones in a GitLab project with filtering options
+56. `get_milestone` - Get details of a specific milestone
+57. `create_milestone` - Create a new milestone in a GitLab project
+58. `edit_milestone ` - Edit an existing milestone in a GitLab project
+59. `delete_milestone` - Delete a milestone from a GitLab project
+60. `get_milestone_issue` - Get issues associated with a specific milestone
+61. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
+62. `promote_milestone` - Promote a milestone to the next stage
+63. `get_milestone_burndown_events` - Get burndown events for a specific milestone
 <!-- TOOLS-END -->

package/build/index.js

@@ -13,7 +13,7 @@ import { dirname } from "path";
 import fs from "fs";
 import path from "path";
 import { URL } from "url";
-import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabIssueSchema, GitLabMergeRequestSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabSearchResponseSchema, GitLabTreeSchema, GitLabCommitSchema, GitLabNamespaceSchema, GitLabNamespaceExistsResponseSchema, GitLabProjectSchema, CreateOrUpdateFileSchema, SearchRepositoriesSchema, CreateRepositorySchema, GetFileContentsSchema, PushFilesSchema, CreateIssueSchema, CreateMergeRequestSchema, ForkRepositorySchema, CreateBranchSchema, GitLabMergeRequestDiffSchema, GetMergeRequestSchema, GetMergeRequestDiffsSchema, UpdateMergeRequestSchema, ListIssuesSchema, GetIssueSchema, UpdateIssueSchema, DeleteIssueSchema, GitLabIssueLinkSchema, GitLabIssueWithLinkDetailsSchema, ListIssueLinksSchema, ListIssueDiscussionsSchema, GetIssueLinkSchema, CreateIssueLinkSchema, DeleteIssueLinkSchema, ListNamespacesSchema, GetNamespaceSchema, VerifyNamespaceSchema, GetProjectSchema, ListProjectsSchema, ListLabelsSchema, GetLabelSchema, CreateLabelSchema, UpdateLabelSchema, DeleteLabelSchema, CreateNoteSchema, CreateMergeRequestThreadSchema, ListGroupProjectsSchema, ListWikiPagesSchema, GetWikiPageSchema, CreateWikiPageSchema, UpdateWikiPageSchema, DeleteWikiPageSchema, GitLabWikiPageSchema, GetRepositoryTreeSchema, GitLabTreeItemSchema, GitLabPipelineSchema, GetPipelineSchema, ListPipelinesSchema, ListPipelineJobsSchema, 
+import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabIssueSchema, GitLabMergeRequestSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabSearchResponseSchema, GitLabTreeSchema, GitLabCommitSchema, GitLabNamespaceSchema, GitLabNamespaceExistsResponseSchema, GitLabProjectSchema, CreateOrUpdateFileSchema, SearchRepositoriesSchema, CreateRepositorySchema, GetFileContentsSchema, PushFilesSchema, CreateIssueSchema, CreateMergeRequestSchema, ForkRepositorySchema, CreateBranchSchema, GitLabMergeRequestDiffSchema, GetMergeRequestSchema, GetMergeRequestDiffsSchema, UpdateMergeRequestSchema, ListIssuesSchema, GetIssueSchema, UpdateIssueSchema, DeleteIssueSchema, GitLabIssueLinkSchema, GitLabIssueWithLinkDetailsSchema, ListIssueLinksSchema, ListIssueDiscussionsSchema, GetIssueLinkSchema, CreateIssueLinkSchema, DeleteIssueLinkSchema, ListNamespacesSchema, GetNamespaceSchema, VerifyNamespaceSchema, GetProjectSchema, ListProjectsSchema, ListLabelsSchema, GetLabelSchema, CreateLabelSchema, UpdateLabelSchema, DeleteLabelSchema, CreateNoteSchema, CreateMergeRequestThreadSchema, ListGroupProjectsSchema, ListWikiPagesSchema, GetWikiPageSchema, CreateWikiPageSchema, UpdateWikiPageSchema, DeleteWikiPageSchema, GitLabWikiPageSchema, GetRepositoryTreeSchema, GitLabTreeItemSchema, GitLabPipelineSchema, GetPipelineSchema, ListPipelinesSchema, ListPipelineJobsSchema, CreatePipelineSchema, RetryPipelineSchema, CancelPipelineSchema, 
 // pipeline job schemas
 GetPipelineJobOutputSchema, GitLabPipelineJobSchema, 
 // Discussion Schemas
@@ -49,6 +49,7 @@ const GITLAB_PERSONAL_ACCESS_TOKEN = process.env.GITLAB_PERSONAL_ACCESS_TOKEN;
 const GITLAB_READ_ONLY_MODE = process.env.GITLAB_READ_ONLY_MODE === "true";
 const USE_GITLAB_WIKI = process.env.USE_GITLAB_WIKI === "true";
 const USE_MILESTONE = process.env.USE_MILESTONE === "true";
+const USE_PIPELINE = process.env.USE_PIPELINE === "true";
 // Add proxy configuration
 const HTTP_PROXY = process.env.HTTP_PROXY;
 const HTTPS_PROXY = process.env.HTTPS_PROXY;
@@ -339,6 +340,21 @@ const allTools = [
         description: "Get the output/trace of a GitLab pipeline job number",
         inputSchema: zodToJsonSchema(GetPipelineJobOutputSchema),
     },
+    {
+        name: "create_pipeline",
+        description: "Create a new pipeline for a branch or tag",
+        inputSchema: zodToJsonSchema(CreatePipelineSchema),
+    },
+    {
+        name: "retry_pipeline",
+        description: "Retry a failed or canceled pipeline",
+        inputSchema: zodToJsonSchema(RetryPipelineSchema),
+    },
+    {
+        name: "cancel_pipeline",
+        description: "Cancel a running pipeline",
+        inputSchema: zodToJsonSchema(CancelPipelineSchema),
+    },
     {
         name: "list_merge_requests",
         description: "List merge requests in a GitLab project with filtering options",
@@ -446,6 +462,17 @@ const milestoneToolNames = [
     "promote_milestone",
     "get_milestone_burndown_events",
 ];
+// Define which tools are related to pipelines and can be toggled by USE_PIPELINE
+const pipelineToolNames = [
+    "list_pipelines",
+    "get_pipeline",
+    "list_pipeline_jobs",
+    "get_pipeline_job",
+    "get_pipeline_job_output",
+    "create_pipeline",
+    "retry_pipeline",
+    "cancel_pipeline",
+];
 /**
  * Smart URL handling for GitLab API
  *
@@ -1857,6 +1884,69 @@ async function getPipelineJobOutput(projectId, jobId) {
     await handleGitLabError(response);
     return await response.text();
 }
+/**
+ * Create a new pipeline
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {string} ref - The branch or tag to run the pipeline on
+ * @param {Array} variables - Optional variables for the pipeline
+ * @returns {Promise<GitLabPipeline>} The created pipeline
+ */
+async function createPipeline(projectId, ref, variables) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipeline`);
+    const body = { ref };
+    if (variables && variables.length > 0) {
+        body.variables = variables.reduce((acc, { key, value }) => {
+            acc[key] = value;
+            return acc;
+        }, {});
+    }
+    const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: DEFAULT_HEADERS,
+        body: JSON.stringify(body),
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabPipelineSchema.parse(data);
+}
+/**
+ * Retry a pipeline
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} pipelineId - The ID of the pipeline to retry
+ * @returns {Promise<GitLabPipeline>} The retried pipeline
+ */
+async function retryPipeline(projectId, pipelineId) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/retry`);
+    const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabPipelineSchema.parse(data);
+}
+/**
+ * Cancel a pipeline
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} pipelineId - The ID of the pipeline to cancel
+ * @returns {Promise<GitLabPipeline>} The canceled pipeline
+ */
+async function cancelPipeline(projectId, pipelineId) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/cancel`);
+    const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabPipelineSchema.parse(data);
+}
 /**
  * Get the repository tree for a project
  * @param {string} projectId - The ID or URL-encoded path of the project
@@ -2064,9 +2154,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         ? tools0
         : tools0.filter(tool => !wikiToolNames.includes(tool.name));
     // Toggle milestone tools by USE_MILESTONE flag
-    let tools = USE_MILESTONE
+    const tools2 = USE_MILESTONE
         ? tools1
         : tools1.filter(tool => !milestoneToolNames.includes(tool.name));
+    // Toggle pipeline tools by USE_PIPELINE flag
+    let tools = USE_PIPELINE
+        ? tools2
+        : tools2.filter(tool => !pipelineToolNames.includes(tool.name));
     // <<< START: Gemini 호환성을 위해 $schema 제거 >>>
     tools = tools.map(tool => {
         // inputSchema가 존재하고 객체인지 확인
@@ -2561,6 +2655,42 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "create_pipeline": {
+                const { project_id, ref, variables } = CreatePipelineSchema.parse(request.params.arguments);
+                const pipeline = await createPipeline(project_id, ref, variables);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Created pipeline #${pipeline.id} for ${ref}. Status: ${pipeline.status}\nWeb URL: ${pipeline.web_url}`,
+                        },
+                    ],
+                };
+            }
+            case "retry_pipeline": {
+                const { project_id, pipeline_id } = RetryPipelineSchema.parse(request.params.arguments);
+                const pipeline = await retryPipeline(project_id, pipeline_id);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Retried pipeline #${pipeline.id}. Status: ${pipeline.status}\nWeb URL: ${pipeline.web_url}`,
+                        },
+                    ],
+                };
+            }
+            case "cancel_pipeline": {
+                const { project_id, pipeline_id } = CancelPipelineSchema.parse(request.params.arguments);
+                const pipeline = await cancelPipeline(project_id, pipeline_id);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Canceled pipeline #${pipeline.id}. Status: ${pipeline.status}\nWeb URL: ${pipeline.web_url}`,
+                        },
+                    ],
+                };
+            }
             case "list_merge_requests": {
                 const args = ListMergeRequestsSchema.parse(request.params.arguments);
                 const mergeRequests = await listMergeRequests(args.project_id, args);

package/build/schemas.js

@@ -150,6 +150,28 @@ export const ListPipelineJobsSchema = z.object({
     page: z.number().optional().describe("Page number for pagination"),
     per_page: z.number().optional().describe("Number of items per page (max 100)"),
 });
+// Schema for creating a new pipeline
+export const CreatePipelineSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    ref: z.string().describe("The branch or tag to run the pipeline on"),
+    variables: z
+        .array(z.object({
+        key: z.string().describe("The key of the variable"),
+        value: z.string().describe("The value of the variable"),
+    }))
+        .optional()
+        .describe("An array of variables to use for the pipeline"),
+});
+// Schema for retrying a pipeline
+export const RetryPipelineSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    pipeline_id: z.number().describe("The ID of the pipeline to retry"),
+});
+// Schema for canceling a pipeline
+export const CancelPipelineSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    pipeline_id: z.number().describe("The ID of the pipeline to cancel"),
+});
 // Schema for the input parameters for pipeline job operations
 export const GetPipelineJobOutputSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
@@ -550,21 +572,21 @@ export const GitLabDiscussionNoteSchema = z.object({
         old_path: z.string(),
         new_path: z.string(),
         position_type: z.enum(["text", "image", "file"]),
-        old_line: z.number().nullable(),
-        new_line: z.number().nullable(),
+        old_line: z.number().nullish(), // This is missing for image diffs
+        new_line: z.number().nullish(), // This is missing for image diffs
         line_range: z
             .object({
             start: z.object({
                 line_code: z.string(),
                 type: z.enum(["new", "old", "expanded"]),
-                old_line: z.number().nullable(),
-                new_line: z.number().nullable(),
+                old_line: z.number().nullish(), // This is missing for image diffs
+                new_line: z.number().nullish(), // This is missing for image diffs
             }),
             end: z.object({
                 line_code: z.string(),
                 type: z.enum(["new", "old", "expanded"]),
-                old_line: z.number().nullable(),
-                new_line: z.number().nullable(),
+                old_line: z.number().nullish(), // This is missing for image diffs
+                new_line: z.number().nullish(), // This is missing for image diffs
             }),
         })
             .nullable()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "1.0.51",
+  "version": "1.0.53",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",