@zereight/mcp-gitlab 2.0.3 → 2.0.5

package/README.md

@@ -1,4 +1,6 @@
-# Better GitLab MCP Server
+# GitLab MCP Server
+
+[![Star History Chart](https://api.star-history.com/svg?repos=zereight/gitlab-mcp&type=Date)](https://www.star-history.com/#zereight/gitlab-mcp&Date)
 
 ## @zereight/mcp-gitlab
 
@@ -10,7 +12,7 @@ GitLab MCP(Model Context Protocol) Server. **Includes bug fixes and improvements
 
 ## Usage
 
-### Using with Claude App, Cline, Roo Code, Cursor
+### Using with Claude App, Cline, Roo Code, Cursor, Kilo Code
 
 When using with the Claude App, you need to set up your API key and URLs directly.
 
@@ -19,7 +21,7 @@ When using with the Claude App, you need to set up your API key and URLs directl
 ```json
 {
   "mcpServers": {
-    "GitLab communication server": {
+    "gitlab": {
       "command": "npx",
       "args": ["-y", "@zereight/mcp-gitlab"],
       "env": {
@@ -72,7 +74,7 @@ When using with the Claude App, you need to set up your API key and URLs directl
 ```json
 {
   "mcpServers": {
-    "GitLab communication server": {
+    "gitlab": {
       "command": "docker",
       "args": [
         "run",
@@ -110,7 +112,7 @@ When using with the Claude App, you need to set up your API key and URLs directl
 ```shell
 docker run -i --rm \
   -e GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token \
-  -e GITLAB_API_URL= "https://gitlab.com/api/v4"\
+  -e GITLAB_API_URL="https://gitlab.com/api/v4" \
   -e GITLAB_READ_ONLY_MODE=true \
   -e USE_GITLAB_WIKI=true \
   -e USE_MILESTONE=true \
@@ -123,7 +125,7 @@ docker run -i --rm \
 ```json
 {
   "mcpServers": {
-    "GitLab communication server": {
+    "gitlab": {
       "type": "sse",
       "url": "http://localhost:3333/sse"
     }
@@ -131,10 +133,8 @@ docker run -i --rm \
 }
 ```
 
-
 - streamable-http
 
-
 ```shell
 docker run -i --rm \
   -e GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token \
@@ -151,20 +151,14 @@ docker run -i --rm \
 ```json
 {
   "mcpServers": {
-    "GitLab communication server": {
+    "gitlab": {
+      "type": "streamable-http",
       "url": "http://localhost:3333/mcp"
     }
   }
 }
 ```
 
-
-#### Docker Image Push
-
-```shell
-$ sh scripts/image_push.sh docker_user_name
-```
-
 ### Environment Variables
 
 - `GITLAB_PERSONAL_ACCESS_TOKEN`: Your GitLab personal access token.
@@ -174,18 +168,21 @@ $ sh scripts/image_push.sh docker_user_name
   - Single value `123`: MCP server can only access project 123 and uses it as default
   - Multiple values `123,456,789`: MCP server can access projects 123, 456, and 789 but requires explicit project ID in requests
 - `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.
+- `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.
 
-[![Star History Chart](https://api.star-history.com/svg?repos=zereight/gitlab-mcp&type=Date)](https://www.star-history.com/#zereight/gitlab-mcp&Date)
-
 ## Tools 🛠️
 
-+<!-- TOOLS-START -->
+<details>
+<summary>Click to expand</summary>
+
+<!-- TOOLS-START -->
+
 1. `merge_merge_request` - Merge a merge request in a GitLab project
 2. `create_or_update_file` - Create or update a single file in a GitLab project
 3. `search_repositories` - Search for GitLab projects
@@ -252,21 +249,28 @@ $ sh scripts/image_push.sh docker_user_name
 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({
@@ -80,6 +80,7 @@ const GITLAB_PERSONAL_ACCESS_TOKEN = process.env.GITLAB_PERSONAL_ACCESS_TOKEN;
 const GITLAB_AUTH_COOKIE_PATH = process.env.GITLAB_AUTH_COOKIE_PATH;
 const IS_OLD = process.env.GITLAB_IS_OLD === "true";
 const GITLAB_READ_ONLY_MODE = process.env.GITLAB_READ_ONLY_MODE === "true";
+const GITLAB_DENIED_TOOLS_REGEX = process.env.GITLAB_DENIED_TOOLS_REGEX ? new RegExp(process.env.GITLAB_DENIED_TOOLS_REGEX) : undefined;
 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";
@@ -544,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",
@@ -629,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 = [
@@ -675,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 = [
@@ -708,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
@@ -2591,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
@@ -3098,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
@@ -3113,6 +3256,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         : 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));
+    tools = GITLAB_DENIED_TOOLS_REGEX ? tools.filter(tool => !GITLAB_DENIED_TOOLS_REGEX.test(tool.name)) : tools;
     // <<< START: Gemini 호환성을 위해 $schema 제거 >>>
     tools = tools.map(tool => {
         // inputSchema가 존재하고 객체인지 확인
@@ -3782,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);
@@ -3942,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

@@ -20,7 +20,7 @@ export const GitLabPipelineSchema = z.object({
     duration: z.number().nullable().optional(),
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
-    coverage: z.number().nullable().optional(),
+    coverage: z.coerce.number().nullable().optional(),
     user: z
         .object({
         id: z.coerce.string(),
@@ -58,7 +58,7 @@ export const GitLabPipelineJobSchema = z.object({
     name: z.string(),
     ref: z.string(),
     tag: flexibleBoolean,
-    coverage: z.number().nullable().optional(),
+    coverage: z.coerce.number().nullable().optional(),
     created_at: z.string(),
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
@@ -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.3",
+  "version": "2.0.5",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",
@@ -21,7 +21,6 @@
     "dev": "npm run build && node build/index.js",
     "watch": "tsc --watch",
     "deploy": "npm publish --access public",
-    "generate-tools": "npx ts-node scripts/generate-tools-readme.ts",
     "changelog": "auto-changelog -p",
     "test": "node test/validate-api.js",
     "test:integration": "node test/validate-api.js",

package/build/scripts/generate-tools-readme.js

@@ -1,41 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-async function main() {
-    const repoRoot = path.resolve(__dirname, "..");
-    const indexPath = path.join(repoRoot, "index.ts");
-    const readmePath = path.join(repoRoot, "README.md");
-    // 1. Read index.ts
-    const code = fs.readFileSync(indexPath, "utf-8");
-    // 2. Extract allTools array block
-    const match = code.match(/const allTools = \[([\s\S]*?)\];/);
-    if (!match) {
-        console.error("Unable to locate allTools array in index.ts");
-        process.exit(1);
-    }
-    const toolsBlock = match[1];
-    // 3. Parse tool entries
-    const toolRegex = /name:\s*"([^"]+)",[\s\S]*?description:\s*"([^"]+)"/g;
-    const tools = [];
-    let m;
-    while ((m = toolRegex.exec(toolsBlock)) !== null) {
-        tools.push({ name: m[1], description: m[2] });
-    }
-    // 4. Generate markdown
-    const lines = tools.map((tool, index) => {
-        return `${index + 1}. \`${tool.name}\` - ${tool.description}`;
-    });
-    const markdown = lines.join("\n");
-    // 5. Read README.md and replace between markers
-    const readme = fs.readFileSync(readmePath, "utf-8");
-    const updated = readme.replace(/<!-- TOOLS-START -->([\s\S]*?)<!-- TOOLS-END -->/, `<!-- TOOLS-START -->\n${markdown}\n<!-- TOOLS-END -->`);
-    // 6. Write back
-    fs.writeFileSync(readmePath, updated, "utf-8");
-    console.log("README.md tools section updated.");
-}
-main().catch(err => {
-    console.error(err);
-    process.exit(1);
-});