@zereight/mcp-gitlab 2.0.4 → 2.0.5

package/README.md

@@ -171,7 +171,7 @@ docker run -i --rm \
 - `GITLAB_DENIED_TOOLS_REGEX`: When set as a regular expression, it excludes the matching tools.
 - `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.
+- `USE_PIPELINE`: When set to 'true', enables the pipeline-related tools (list_pipelines, get_pipeline, list_pipeline_jobs, list_pipeline_trigger_jobs, get_pipeline_job, get_pipeline_job_output, create_pipeline, retry_pipeline, cancel_pipeline, play_pipeline_job, retry_pipeline_job, cancel_pipeline_job). By default, pipeline features are disabled.
 - `GITLAB_AUTH_COOKIE_PATH`: Path to an authentication cookie file for GitLab instances that require cookie-based authentication. When provided, the cookie will be included in all GitLab API requests.
 - `SSE`: When set to 'true', enables the Server-Sent Events transport.
 - `STREAMABLE_HTTP`: When set to 'true', enables the Streamable HTTP transport. If both **SSE** and **STREAMABLE_HTTP** are set to 'true', the server will prioritize Streamable HTTP over SSE transport.
@@ -249,23 +249,28 @@ docker run -i --rm \
 64. `create_pipeline` - Create a new pipeline for a branch or tag
 65. `retry_pipeline` - Retry a failed or canceled pipeline
 66. `cancel_pipeline` - Cancel a running pipeline
-67. `list_merge_requests` - List merge requests in a GitLab project with filtering options
-68. `list_milestones` - List milestones in a GitLab project with filtering options
-69. `get_milestone` - Get details of a specific milestone
-70. `create_milestone` - Create a new milestone in a GitLab project
-71. `edit_milestone` - Edit an existing milestone in a GitLab project
-72. `delete_milestone` - Delete a milestone from a GitLab project
-73. `get_milestone_issue` - Get issues associated with a specific milestone
-74. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
-75. `promote_milestone` - Promote a milestone to the next stage
-76. `get_milestone_burndown_events` - Get burndown events for a specific milestone
-77. `get_users` - Get GitLab user details by usernames
-78. `list_commits` - List repository commits with filtering options
-79. `get_commit` - Get details of a specific commit
-80. `get_commit_diff` - Get changes/diffs of a specific commit
-81. `list_group_iterations` - List group iterations with filtering options
-82. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
-83. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
+67. `play_pipeline_job` - Run a manual pipeline job
+68. `retry_pipeline_job` - Retry a failed or canceled pipeline job
+69. `cancel_pipeline_job` - Cancel a running pipeline job
+70. `list_merge_requests` - List merge requests in a GitLab project with filtering options
+71. `list_milestones` - List milestones in a GitLab project with filtering options
+72. `get_milestone` - Get details of a specific milestone
+73. `create_milestone` - Create a new milestone in a GitLab project
+74. `edit_milestone` - Edit an existing milestone in a GitLab project
+75. `delete_milestone` - Delete a milestone from a GitLab project
+76. `get_milestone_issue` - Get issues associated with a specific milestone
+77. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
+78. `promote_milestone` - Promote a milestone to the next stage
+79. `get_milestone_burndown_events` - Get burndown events for a specific milestone
+80. `get_users` - Get GitLab user details by usernames
+81. `list_commits` - List repository commits with filtering options
+82. `get_commit` - Get details of a specific commit
+83. `get_commit_diff` - Get changes/diffs of a specific commit
+84. `list_group_iterations` - List group iterations with filtering options
+85. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
+86. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
+87. `list_events` - List all events for the currently authenticated user
+88. `get_project_events` - List all visible events for a specified project
 <!-- TOOLS-END -->
 
 </details>

package/build/index.js

@@ -20,7 +20,7 @@ import { zodToJsonSchema } from "zod-to-json-schema";
 import { Agent } from "http";
 import { Agent as HttpsAgent } from "https";
 import { URL } from "url";
-import { BulkPublishDraftNotesSchema, CancelPipelineSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateLabelSchema, // Added
+import { BulkPublishDraftNotesSchema, CancelPipelineJobSchema, CancelPipelineSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateLabelSchema, // Added
 CreateMergeRequestNoteSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateRepositorySchema, CreateWikiPageSchema, DeleteDraftNoteSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteLabelSchema, DeleteProjectMilestoneSchema, DeleteWikiPageSchema, EditProjectMilestoneSchema, ForkRepositorySchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetDraftNoteSchema, GetFileContentsSchema, GetIssueLinkSchema, GetIssueSchema, GetLabelSchema, GetMergeRequestDiffsSchema, GetMergeRequestSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetNamespaceSchema, 
 // pipeline job schemas
 GetPipelineJobOutputSchema, GetPipelineSchema, GetProjectMilestoneSchema, GetProjectSchema, GetRepositoryTreeSchema, GetUsersSchema, GetWikiPageSchema, GitLabCommitSchema, GitLabCompareResultSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabDiffSchema, 
@@ -29,7 +29,7 @@ GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, 
 // Draft Notes Schemas
 GitLabDraftNoteSchema, GitLabForkSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestSchema, GitLabMilestonesSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabPipelineSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabTreeSchema, GitLabUserSchema, GitLabUsersResponseSchema, GitLabWikiPageSchema, GroupIteration, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, ListGroupProjectsSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListLabelsSchema, ListMergeRequestDiffsSchema, // Added
-ListMergeRequestDiscussionsSchema, ListMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListPipelineTriggerJobsSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, MarkdownUploadSchema, DownloadAttachmentSchema, MergeMergeRequestSchema, MyIssuesSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, RetryPipelineSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateLabelSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema } from "./schemas.js";
+ListMergeRequestDiscussionsSchema, ListMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListPipelineTriggerJobsSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, MarkdownUploadSchema, DownloadAttachmentSchema, MergeMergeRequestSchema, MyIssuesSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateLabelSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema } from "./schemas.js";
 import { randomUUID } from "crypto";
 import { pino } from "pino";
 const logger = pino({
@@ -545,6 +545,21 @@ const allTools = [
         description: "Cancel a running pipeline",
         inputSchema: zodToJsonSchema(CancelPipelineSchema),
     },
+    {
+        name: "play_pipeline_job",
+        description: "Run a manual pipeline job",
+        inputSchema: zodToJsonSchema(PlayPipelineJobSchema),
+    },
+    {
+        name: "retry_pipeline_job",
+        description: "Retry a failed or canceled pipeline job",
+        inputSchema: zodToJsonSchema(RetryPipelineJobSchema),
+    },
+    {
+        name: "cancel_pipeline_job",
+        description: "Cancel a running pipeline job",
+        inputSchema: zodToJsonSchema(CancelPipelineJobSchema),
+    },
     {
         name: "list_merge_requests",
         description: "List merge requests in a GitLab project with filtering options",
@@ -630,6 +645,16 @@ const allTools = [
         description: "Download an uploaded file from a GitLab project by secret and filename",
         inputSchema: zodToJsonSchema(DownloadAttachmentSchema),
     },
+    {
+        name: "list_events",
+        description: "List all events for the currently authenticated user. Note: before/after parameters accept date format YYYY-MM-DD only",
+        inputSchema: zodToJsonSchema(ListEventsSchema),
+    },
+    {
+        name: "get_project_events",
+        description: "List all visible events for a specified project. Note: before/after parameters accept date format YYYY-MM-DD only",
+        inputSchema: zodToJsonSchema(GetProjectEventsSchema),
+    },
 ];
 // Define which tools are read-only
 const readOnlyTools = [
@@ -676,6 +701,8 @@ const readOnlyTools = [
     "list_group_iterations",
     "get_group_iteration",
     "download_attachment",
+    "list_events",
+    "get_project_events",
 ];
 // Define which tools are related to wiki and can be toggled by USE_GITLAB_WIKI
 const wikiToolNames = [
@@ -709,6 +736,9 @@ const pipelineToolNames = [
     "create_pipeline",
     "retry_pipeline",
     "cancel_pipeline",
+    "play_pipeline_job",
+    "retry_pipeline_job",
+    "cancel_pipeline_job",
 ];
 /**
  * Smart URL handling for GitLab API
@@ -2592,6 +2622,70 @@ async function cancelPipeline(projectId, pipelineId) {
     const data = await response.json();
     return GitLabPipelineSchema.parse(data);
 }
+/**
+ * Run a manual job
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} jobId - The ID of the job to run
+ * @param {Object} variables - Optional job variables
+ * @returns {Promise<GitLabPipelineJob>} The run job
+ */
+async function playPipelineJob(projectId, jobId, variables) {
+    projectId = decodeURIComponent(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/jobs/${jobId}/play`);
+    const body = {};
+    if (variables && variables.length > 0) {
+        body.job_variables_attributes = variables;
+    }
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+        method: "POST",
+        body: Object.keys(body).length > 0 ? JSON.stringify(body) : undefined,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabPipelineJobSchema.parse(data);
+}
+/**
+ * Retry a job
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} jobId - The ID of the job to retry
+ * @returns {Promise<GitLabPipelineJob>} The retried job
+ */
+async function retryPipelineJob(projectId, jobId) {
+    projectId = decodeURIComponent(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/jobs/${jobId}/retry`);
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+        method: "POST",
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabPipelineJobSchema.parse(data);
+}
+/**
+ * Cancel a job
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} jobId - The ID of the job to cancel
+ * @param {boolean} force - Force cancellation of the job
+ * @returns {Promise<GitLabPipelineJob>} The canceled job
+ */
+async function cancelPipelineJob(projectId, jobId, force) {
+    projectId = decodeURIComponent(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/jobs/${jobId}/cancel`);
+    if (force !== undefined) {
+        url.searchParams.append('force', force.toString());
+    }
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+        method: "POST",
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabPipelineJobSchema.parse(data);
+}
 /**
  * Get the repository tree for a project
  * @param {string} projectId - The ID or URL-encoded path of the project
@@ -3099,6 +3193,54 @@ async function downloadAttachment(projectId, secret, filename, localPath) {
     fs.writeFileSync(savePath, Buffer.from(buffer));
     return savePath;
 }
+/**
+ * List all events for the currently authenticated user
+ * @param {Object} options - Options for listing events
+ * @returns {Promise<GitLabEvent[]>} List of events
+ */
+async function listEvents(options = {}) {
+    const url = new URL(`${GITLAB_API_URL}/events`);
+    // Add all query parameters
+    Object.entries(options).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, value.toString());
+        }
+    });
+    const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: DEFAULT_HEADERS,
+    });
+    if (!response.ok) {
+        await handleGitLabError(response);
+    }
+    const data = await response.json();
+    return GitLabEventSchema.array().parse(data);
+}
+/**
+ * List all visible events for a specified project
+ * @param {string} projectId - Project ID or URL-encoded path
+ * @param {Object} options - Options for getting project events
+ * @returns {Promise<GitLabEvent[]>} List of project events
+ */
+async function getProjectEvents(projectId, options = {}) {
+    const effectiveProjectId = getEffectiveProjectId(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}/events`);
+    // Add all query parameters
+    Object.entries(options).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, value.toString());
+        }
+    });
+    const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: DEFAULT_HEADERS,
+    });
+    if (!response.ok) {
+        await handleGitLabError(response);
+    }
+    const data = await response.json();
+    return GitLabEventSchema.array().parse(data);
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     // Apply read-only filter first
     const tools0 = GITLAB_READ_ONLY_MODE
@@ -3784,6 +3926,42 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "play_pipeline_job": {
+                const { project_id, job_id, job_variables_attributes } = PlayPipelineJobSchema.parse(request.params.arguments);
+                const job = await playPipelineJob(project_id, job_id, job_variables_attributes);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Ran job #${job.id} (${job.name}). Status: ${job.status}\nWeb URL: ${job.web_url}`,
+                        },
+                    ],
+                };
+            }
+            case "retry_pipeline_job": {
+                const { project_id, job_id } = RetryPipelineJobSchema.parse(request.params.arguments);
+                const job = await retryPipelineJob(project_id, job_id);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Retried job #${job.id} (${job.name}). Status: ${job.status}\nWeb URL: ${job.web_url}`,
+                        },
+                    ],
+                };
+            }
+            case "cancel_pipeline_job": {
+                const { project_id, job_id, force } = CancelPipelineJobSchema.parse(request.params.arguments);
+                const job = await cancelPipelineJob(project_id, job_id, force);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Canceled job #${job.id} (${job.name}). Status: ${job.status}\nWeb URL: ${job.web_url}`,
+                        },
+                    ],
+                };
+            }
             case "list_merge_requests": {
                 const args = ListMergeRequestsSchema.parse(request.params.arguments);
                 const mergeRequests = await listMergeRequests(args.project_id, args);
@@ -3944,6 +4122,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify({ success: true, file_path: filePath }, null, 2) }],
                 };
             }
+            case "list_events": {
+                const args = ListEventsSchema.parse(request.params.arguments);
+                const events = await listEvents(args);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(events, null, 2) }],
+                };
+            }
+            case "get_project_events": {
+                const args = GetProjectEventsSchema.parse(request.params.arguments);
+                const { project_id, ...options } = args;
+                const events = await getProjectEvents(project_id, options);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(events, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${request.params.name}`);
         }

package/build/schemas.js

@@ -282,6 +282,31 @@ export const GetPipelineJobOutputSchema = z.object({
         .optional()
         .describe("Number of lines to skip from the end of the log (default: 0)"),
 });
+// Schema for pipeline job control operations
+export const PipelineJobControlSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    job_id: z.coerce.string().describe("The ID of the job"),
+});
+// Schema for running a manual job
+export const PlayPipelineJobSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    job_id: z.coerce.string().describe("The ID of the job"),
+    job_variables_attributes: z
+        .array(z.object({
+        key: z.string().describe("Variable key"),
+        value: z.string().describe("Variable value"),
+    }))
+        .optional()
+        .describe("Custom job variables to use when running the job"),
+});
+// Schema for retrying a job
+export const RetryPipelineJobSchema = PipelineJobControlSchema;
+// Schema for canceling a job  
+export const CancelPipelineJobSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    job_id: z.coerce.string().describe("The ID of the job"),
+    force: z.boolean().optional().describe("Force cancellation of the job"),
+});
 // User schemas
 export const GitLabUserSchema = z.object({
     username: z.string().optional(), // Changed from login to match GitLab API
@@ -1681,3 +1706,49 @@ export const ListGroupIterationsSchema = z
         .describe("Return only iterations updated after the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z)."),
 })
     .merge(PaginationOptionsSchema);
+// Events API schemas
+export const GitLabEventAuthorSchema = z.object({
+    id: z.coerce.string(),
+    name: z.string(),
+    username: z.string(),
+    state: z.string(),
+    avatar_url: z.string().nullable(),
+    web_url: z.string(),
+});
+export const GitLabEventSchema = z.object({
+    id: z.coerce.string(),
+    project_id: z.coerce.string(),
+    action_name: z.string(),
+    target_id: z.coerce.string().nullable(),
+    target_iid: z.coerce.string().nullable(),
+    target_type: z.string().nullable(),
+    author_id: z.coerce.string(),
+    target_title: z.string().nullable(),
+    created_at: z.string(),
+    author: GitLabEventAuthorSchema,
+    author_username: z.string(),
+    imported: flexibleBoolean,
+    imported_from: z.string(),
+}).passthrough(); // Allow additional fields
+// List events schema
+export const ListEventsSchema = z.object({
+    action: z.string().optional().describe("If defined, returns events with the specified action type"),
+    target_type: z.enum(["epic", "issue", "merge_request", "milestone", "note", "project", "snippet", "user"]).optional().describe("If defined, returns events with the specified target type"),
+    before: z.string().optional().describe("If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30"),
+    after: z.string().optional().describe("If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28"),
+    scope: z.string().optional().describe("Include all events across a user's projects"),
+    sort: z.enum(["asc", "desc"]).optional().describe("Direction to sort the results by creation date. Default: desc"),
+    page: z.number().optional().describe("Returns the specified results page. Default: 1"),
+    per_page: z.number().optional().describe("Number of results per page. Default: 20"),
+});
+// Get project events schema
+export const GetProjectEventsSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    action: z.string().optional().describe("If defined, returns events with the specified action type"),
+    target_type: z.enum(["epic", "issue", "merge_request", "milestone", "note", "project", "snippet", "user"]).optional().describe("If defined, returns events with the specified target type"),
+    before: z.string().optional().describe("If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30"),
+    after: z.string().optional().describe("If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28"),
+    sort: z.enum(["asc", "desc"]).optional().describe("Direction to sort the results by creation date. Default: desc"),
+    page: z.number().optional().describe("Returns the specified results page. Default: 1"),
+    per_page: z.number().optional().describe("Number of results per page. Default: 20"),
+});

package/package.json

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