@zereight/mcp-gitlab 2.1.10 → 2.1.12

package/build/test/test-merge-request-pipelines.js

@@ -0,0 +1,106 @@
+import { describe, test, before, after } from "node:test";
+import assert from "node:assert";
+import { spawn } from "child_process";
+import { MockGitLabServer, findMockServerPort } from "./utils/mock-gitlab-server.js";
+const MOCK_TOKEN = "glpat-mr-pipelines-test-token";
+const TEST_PROJECT_ID = "123";
+const TEST_MR_IID = "1";
+async function callTool(toolName, args, env) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn("node", ["build/index.js"], {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: {
+                ...process.env,
+                ...env,
+                GITLAB_READ_ONLY_MODE: "true",
+            },
+        });
+        let output = "";
+        let errorOutput = "";
+        proc.stdout?.on("data", d => output += d);
+        proc.stderr?.on("data", d => errorOutput += d);
+        proc.on("close", code => {
+            if (code !== 0) {
+                reject(new Error(`Process exited with code ${code}: ${errorOutput}`));
+                return;
+            }
+            const line = output.split("\n").find(l => l.startsWith("{"));
+            if (!line) {
+                reject(new Error("No JSON output found"));
+                return;
+            }
+            try {
+                const response = JSON.parse(line);
+                if (response.error) {
+                    reject(response.error);
+                    return;
+                }
+                const content = response.result?.content?.[0]?.text;
+                resolve(content ? JSON.parse(content) : response.result);
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+        proc.stdin?.end(JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "tools/call",
+            params: { name: toolName, arguments: args },
+        }) + "\n");
+    });
+}
+describe("list_merge_request_pipelines", () => {
+    let mockGitLab;
+    let mockGitLabUrl;
+    let lastQuery = {};
+    before(async () => {
+        const mockPort = await findMockServerPort(9250);
+        mockGitLab = new MockGitLabServer({
+            port: mockPort,
+            validTokens: [MOCK_TOKEN],
+        });
+        mockGitLab.addMockHandler("get", `/projects/${TEST_PROJECT_ID}/merge_requests/${TEST_MR_IID}/pipelines`, (req, res) => {
+            lastQuery = { ...req.query };
+            res.json([
+                {
+                    id: 77,
+                    sha: "959e04d7c7a30600c894bd3c0cd0e1ce7f42c11d",
+                    ref: "main",
+                    status: "success",
+                },
+                {
+                    id: 78,
+                    sha: "a59e04d7c7a30600c894bd3c0cd0e1ce7f42c22e",
+                    ref: "refs/merge-requests/1/head",
+                    status: "running",
+                    source: "merge_request_event",
+                    web_url: "https://gitlab.mock/test/project/-/pipelines/78",
+                },
+            ]);
+        });
+        await mockGitLab.start();
+        mockGitLabUrl = mockGitLab.getUrl();
+    });
+    after(async () => {
+        await mockGitLab.stop();
+    });
+    test("lists pipelines for a merge request", async () => {
+        const pipelines = await callTool("list_merge_request_pipelines", {
+            project_id: TEST_PROJECT_ID,
+            merge_request_iid: TEST_MR_IID,
+            page: 2,
+            per_page: 10,
+        }, {
+            GITLAB_API_URL: `${mockGitLabUrl}/api/v4`,
+            GITLAB_PERSONAL_ACCESS_TOKEN: MOCK_TOKEN,
+        });
+        assert.ok(Array.isArray(pipelines), "Response should be an array");
+        assert.strictEqual(pipelines.length, 2);
+        assert.strictEqual(pipelines[0].id, "77");
+        assert.strictEqual(pipelines[0].status, "success");
+        assert.strictEqual(pipelines[1].source, "merge_request_event");
+        assert.strictEqual(lastQuery.page, "2");
+        assert.strictEqual(lastQuery.per_page, "10");
+    });
+});

package/build/test/test-token-optimizations.js

@@ -389,7 +389,7 @@ describe("Policy Edge Cases", { concurrency: 1 }, () => {
     test("hiding all toolset tools leaves only discover_tools", async () => {
         const allIssueTools = [
             "create_issue", "list_issues", "my_issues", "get_issue",
-            "update_issue", "delete_issue", "create_issue_note", "update_issue_note",
+            "update_issue", "update_issue_description_patch", "delete_issue", "list_todos", "mark_todo_done", "mark_all_todos_done", "create_issue_note", "update_issue_note",
             "list_issue_links", "list_issue_discussions", "get_issue_link",
             "create_issue_link", "delete_issue_link", "create_note",
             "list_issue_emoji_reactions", "list_issue_note_emoji_reactions",

package/build/test/test-toolset-filtering.js

@@ -16,11 +16,11 @@ const MOCK_PORT_BASE = 9200;
 const MCP_PORT_BASE = 3200;
 // Known tool counts per toolset (from TOOLSET_DEFINITIONS)
 const TOOLSET_TOOL_COUNTS = {
-    merge_requests: 40,
-    issues: 23,
+    merge_requests: 41,
+    issues: 24,
     repositories: 7,
-    branches: 6,
-    projects: 8,
+    branches: 9,
+    projects: 9,
     labels: 5,
     ci: 2,
     pipelines: 19,
@@ -28,7 +28,7 @@ const TOOLSET_TOOL_COUNTS = {
     wiki: 10,
     releases: 7,
     tags: 5,
-    users: 5,
+    users: 7,
     search: 3,
     workitems: 18,
     webhooks: 3,
@@ -63,7 +63,7 @@ const TOOLSET_SAMPLE_TOOLS = {
     merge_requests: ["merge_merge_request", "create_merge_request_thread", "list_draft_notes"],
     issues: ["create_issue", "list_issues", "create_note", "list_todos"],
     repositories: ["search_repositories", "get_file_contents", "push_files"],
-    branches: ["create_branch", "list_commits", "list_commit_statuses", "create_commit_status"],
+    branches: ["create_branch", "get_branch", "list_branches", "delete_branch", "list_commits", "list_commit_statuses", "create_commit_status"],
     projects: ["get_project", "list_namespaces", "list_group_iterations"],
     labels: ["list_labels", "create_label"],
     ci: ["validate_ci_lint", "validate_project_ci_lint"],
@@ -308,6 +308,7 @@ describe("Toolset Filtering", { concurrency: 1 }, () => {
         const writeIssueTools = [
             "create_issue",
             "update_issue",
+            "update_issue_description_patch",
             "delete_issue",
             "mark_todo_done",
             "mark_all_todos_done",

package/build/test/utils/mock-gitlab-server.js

@@ -13,6 +13,8 @@ export class MockGitLabServer {
     // Root-level dynamic router (for OAuth paths not under /api/v4)
     rootRouter;
     rootHandlers = new Map();
+    // In-memory store for mutable resources (issues, etc.)
+    issueStore = new Map();
     constructor(config) {
         this.config = config;
         this.app = express();
@@ -314,6 +316,12 @@ export class MockGitLabServer {
         this.app.get("/api/v4/projects/:projectId/issues/:issue_iid", (req, res) => {
             const issueIid = parseInt(req.params.issue_iid);
             const projectId = req.params.projectId;
+            const storeKey = `${projectId}:${issueIid}`;
+            const stored = this.issueStore.get(storeKey);
+            if (stored) {
+                res.json(stored);
+                return;
+            }
             res.json({
                 id: issueIid,
                 iid: issueIid,
@@ -337,6 +345,44 @@ export class MockGitLabServer {
                 milestone: null,
             });
         });
+        // PUT /api/v4/projects/:projectId/issues/:issue_iid - Update issue
+        this.app.put("/api/v4/projects/:projectId/issues/:issue_iid", (req, res) => {
+            const issueIid = parseInt(req.params.issue_iid);
+            const projectId = req.params.projectId;
+            const storeKey = `${projectId}:${issueIid}`;
+            // Build response from stored data (if previously updated) or defaults
+            const stored = this.issueStore.get(storeKey) || {};
+            const description = req.body?.description ?? stored.description ?? `Description for issue ${issueIid}`;
+            const title = req.body?.title ?? stored.title ?? `Test Issue ${issueIid}`;
+            const state = req.body?.state_event === "close" ? "closed" :
+                req.body?.state_event === "reopen" ? "opened" :
+                    (stored.state ?? "opened");
+            const updatedIssue = {
+                id: issueIid,
+                iid: issueIid,
+                project_id: projectId,
+                title,
+                description,
+                state,
+                created_at: stored.created_at ?? "2024-01-01T00:00:00Z",
+                updated_at: new Date().toISOString(),
+                closed_at: state === "closed" ? new Date().toISOString() : null,
+                web_url: `https://gitlab.mock/project/${projectId}/issues/${issueIid}`,
+                author: {
+                    id: 1,
+                    username: "test-user",
+                    name: "Test User",
+                    avatar_url: null,
+                    web_url: "https://gitlab.mock/test-user",
+                },
+                assignees: [],
+                labels: [],
+                milestone: null,
+            };
+            // Store for subsequent GET requests
+            this.issueStore.set(storeKey, updatedIssue);
+            res.json(updatedIssue);
+        });
         // Mock blob search result
         const mockBlobResults = [
             {

package/build/test/utils/server-launcher.js

@@ -78,11 +78,12 @@ export async function launchServer(config) {
             if (!serverProcess.killed) {
                 serverProcess.kill("SIGTERM");
                 // Force kill if not terminated within 5 seconds
-                setTimeout(() => {
+                const forceKillTimer = setTimeout(() => {
                     if (!serverProcess.killed) {
                         serverProcess.kill("SIGKILL");
                     }
                 }, 5000);
+                forceKillTimer.unref();
             }
         },
     };

package/build/tools/registry.js

@@ -1,7 +1,7 @@
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { toJSONSchema } from "../utils/schema.js";
 import { USE_GITLAB_WIKI, USE_MILESTONE, USE_PIPELINE, } from "../config.js";
-import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, 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, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteDraftNoteSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetDeploymentSchema, GetDraftNoteSchema, GetEnvironmentSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, GetPipelineSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetTimelineEventsSchema, GetUsersSchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListPipelinesSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListReleasesSchema, ListTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UnapproveMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateLabelSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, } from "../schemas.js";
+import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, 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, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteBranchSchema, DeleteDraftNoteSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetDeploymentSchema, GetDraftNoteSchema, GetEnvironmentSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, GetPipelineSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListBranchesSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListPipelinesSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListReleasesSchema, ListTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UnapproveMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, } from "../schemas.js";
 // Define all available tools
 export const allTools = [
     {
@@ -29,6 +29,11 @@ export const allTools = [
         description: "Get the conflicts of a merge request",
         inputSchema: toJSONSchema(GetMergeRequestConflictsSchema),
     },
+    {
+        name: "list_merge_request_pipelines",
+        description: "List pipelines for a merge request with pagination",
+        inputSchema: toJSONSchema(ListMergeRequestPipelinesSchema),
+    },
     {
         name: "execute_graphql",
         description: "Execute a GitLab GraphQL query",
@@ -79,6 +84,21 @@ export const allTools = [
         description: "Create a new branch",
         inputSchema: toJSONSchema(CreateBranchSchema),
     },
+    {
+        name: "get_branch",
+        description: "Get branch details (commit, protection status)",
+        inputSchema: toJSONSchema(GetBranchSchema),
+    },
+    {
+        name: "list_branches",
+        description: "List branches in project with search filter",
+        inputSchema: toJSONSchema(ListBranchesSchema),
+    },
+    {
+        name: "delete_branch",
+        description: "Delete branch from project",
+        inputSchema: toJSONSchema(DeleteBranchSchema),
+    },
     {
         name: "get_merge_request",
         description: "Get details of a merge request (mergeRequestIid or branchName required)",
@@ -311,6 +331,13 @@ export const allTools = [
         description: "Update an issue",
         inputSchema: toJSONSchema(UpdateIssueSchema),
     },
+    {
+        name: "update_issue_description_patch",
+        description: "Apply a patch (search/replace or unified diff) to an issue description. " +
+            "Reduces token usage by allowing small changes without sending the full description. " +
+            "Supports dry_run to preview changes and create_note to summarize updates.",
+        inputSchema: toJSONSchema(UpdateIssueDescriptionPatchSchema),
+    },
     {
         name: "delete_issue",
         description: "Delete an issue",
@@ -631,6 +658,16 @@ export const allTools = [
         description: "Get GitLab user details by usernames",
         inputSchema: toJSONSchema(GetUsersSchema),
     },
+    {
+        name: "get_user",
+        description: "Get user details by ID",
+        inputSchema: toJSONSchema(GetUserSchema),
+    },
+    {
+        name: "whoami",
+        description: "Get current authenticated user details",
+        inputSchema: toJSONSchema(WhoAmISchema),
+    },
     {
         name: "list_commits",
         description: "List repository commits with filtering options",
@@ -671,6 +708,11 @@ export const allTools = [
         description: "Download an uploaded file from a project (images returned as base64; use local_path to save to disk)",
         inputSchema: toJSONSchema(DownloadAttachmentSchema),
     },
+    {
+        name: "health_check",
+        description: "Verify server status and authentication",
+        inputSchema: toJSONSchema(HealthCheckSchema),
+    },
     {
         name: "list_events",
         description: "List events for the authenticated user (before/after: YYYY-MM-DD)",
@@ -882,6 +924,7 @@ export const allTools = [
 // Define which tools are read-only
 export const readOnlyTools = new Set([
     "discover_tools",
+    "health_check",
     "search_repositories",
     "search_code",
     "search_project_code",
@@ -895,7 +938,10 @@ export const readOnlyTools = new Set([
     "get_merge_request_file_diff",
     "list_merge_request_versions",
     "get_merge_request_version",
+    "get_branch",
+    "list_branches",
     "get_branch_diffs",
+    "list_merge_request_pipelines",
     "get_merge_request_note",
     "get_merge_request_notes",
     "get_draft_note",
@@ -944,6 +990,8 @@ export const readOnlyTools = new Set([
     "list_group_wiki_pages",
     "get_group_wiki_page",
     "get_users",
+    "get_user",
+    "whoami",
     "list_commits",
     "get_commit",
     "get_commit_diff",
@@ -996,8 +1044,10 @@ export const destructiveTools = new Set([
     "delete_issue_note_emoji_reaction",
     "delete_work_item_emoji_reaction",
     "delete_work_item_note_emoji_reaction",
+    "delete_branch",
     "merge_merge_request",
     "push_files",
+    "delete_branch",
 ]);
 // Define which tools are related to wiki and can be toggled by USE_GITLAB_WIKI
 export const wikiToolNames = new Set([
@@ -1058,7 +1108,10 @@ export const TOOLSET_DEFINITIONS = [
             "approve_merge_request",
             "unapprove_merge_request",
             "get_merge_request_approval_state",
+            "get_branch",
+            "list_branches",
             "get_merge_request_conflicts",
+            "list_merge_request_pipelines",
             "get_merge_request",
             "get_merge_request_diffs",
             "list_merge_request_changed_files",
@@ -1105,6 +1158,7 @@ export const TOOLSET_DEFINITIONS = [
             "my_issues",
             "get_issue",
             "update_issue",
+            "update_issue_description_patch",
             "delete_issue",
             "list_todos",
             "mark_todo_done",
@@ -1143,6 +1197,9 @@ export const TOOLSET_DEFINITIONS = [
         isDefault: true,
         tools: new Set([
             "create_branch",
+            "get_branch",
+            "list_branches",
+            "delete_branch",
             "list_commits",
             "get_commit",
             "get_commit_diff",
@@ -1162,6 +1219,7 @@ export const TOOLSET_DEFINITIONS = [
             "verify_namespace",
             "list_group_projects",
             "list_group_iterations",
+            "health_check",
         ]),
     },
     {
@@ -1265,6 +1323,8 @@ export const TOOLSET_DEFINITIONS = [
         isDefault: true,
         tools: new Set([
             "get_users",
+            "get_user",
+            "whoami",
             "list_events",
             "get_project_events",
             "upload_markdown",

package/build/utils/patch-helper.js

@@ -0,0 +1,145 @@
+/**
+ * Patch helper for issue description updates.
+ * Supports two patch formats:
+ * - search_replace: exact text search/replace blocks
+ * - unified_diff: standard unified diff via the `diff` library
+ */
+import { applyPatch, createTwoFilesPatch, parsePatch } from "diff";
+/**
+ * Parse a search/replace patch string into blocks.
+ * Format:
+ *   <<<<<<< SEARCH
+ *   text to find
+ *   =======
+ *   text to replace with
+ *   >>>>>>> REPLACE
+ *
+ * Supports multiple blocks.
+ */
+export function parseSearchReplaceBlocks(patch) {
+    const blocks = [];
+    // Match SEARCH...REPLACE blocks (greedy multiline)
+    const regex = /<<<<<<< SEARCH[^\S\n]*\n([\s\S]*?)=======[^\S\n]*\n([\s\S]*?)>>>>>>> REPLACE[^\S\n]*/g;
+    let match;
+    while ((match = regex.exec(patch)) !== null) {
+        let search = match[1];
+        let replace = match[2];
+        // Trim trailing newline from each side (the \n before ======= and before >>>>>>>)
+        if (search.endsWith("\n"))
+            search = search.slice(0, -1);
+        if (replace.endsWith("\n"))
+            replace = replace.slice(0, -1);
+        blocks.push({ search, replace });
+    }
+    // Detect malformed blocks: check if SEARCH/REPLACE markers exist but weren't captured
+    const searchMarkers = (patch.match(/<<<<<<<\s+SEARCH/g) || []).length;
+    const replaceMarkers = (patch.match(/>>>>>>>\s+REPLACE/g) || []).length;
+    if (searchMarkers !== blocks.length || replaceMarkers !== blocks.length) {
+        throw new Error(`Found ${searchMarkers} SEARCH marker(s) and ${replaceMarkers} REPLACE marker(s), ` +
+            `but only parsed ${blocks.length} valid block(s). ` +
+            "Some blocks may be malformed (e.g. missing ======= or >>>>>>> REPLACE). " +
+            "Each block must follow the exact format: <<<<<<< SEARCH\ntext\n=======\nnew text\n>>>>>>> REPLACE");
+    }
+    return blocks;
+}
+/**
+ * Apply search/replace blocks to source text.
+ *
+ * @param source - Current text
+ * @param blocks - Search/replace blocks
+ * @param allowMultiple - If true, replace all occurrences; if false, fail on duplicate match
+ * @returns PatchResult or throws on error
+ */
+export function applySearchReplace(source, blocks, allowMultiple = false) {
+    let current = source;
+    let totalChanges = 0;
+    const changeLines = [];
+    for (const block of blocks) {
+        // Empty SEARCH body would produce an empty regex that corrupts the description
+        if (block.search.length === 0) {
+            throw new Error("Empty SEARCH block is not allowed. " +
+                "Each SEARCH block must contain the text to find. " +
+                "Block:\n---\n" + block.replace.slice(0, 200) + "\n---");
+        }
+        // Count occurrences
+        const escapedSearch = escapeRegex(block.search);
+        const regex = new RegExp(escapedSearch, "g");
+        const occurrences = current.match(regex);
+        if (!occurrences || occurrences.length === 0) {
+            throw new Error(`Search text not found in issue description. Search block:\n---\n${block.search.slice(0, 200)}${block.search.length > 200 ? "..." : ""}\n---`);
+        }
+        if (occurrences.length > 1 && !allowMultiple) {
+            throw new Error(`Search text matches ${occurrences.length} times (expected exactly 1). ` +
+                "Use 'allow_multiple: true' to replace all occurrences.\n" +
+                `Search block:\n---\n${block.search.slice(0, 200)}${block.search.length > 200 ? "..." : ""}\n---`);
+        }
+        // Apply replacement
+        const replacement = block.replace;
+        const replaced = current.replace(regex, () => replacement);
+        // Detect no-op
+        if (replaced === current) {
+            throw new Error(`Replacement did not change the description (identical result). Search block:\n---\n${block.search.slice(0, 200)}${block.search.length > 200 ? "..." : ""}\n---`);
+        }
+        const count = occurrences.length;
+        totalChanges += count;
+        changeLines.push(`Replaced ${count} occurrence(s): "${truncate(block.search, 60)}" → "${truncate(block.replace, 60)}"`);
+        current = replaced;
+    }
+    const summary = changeLines.join("\n");
+    // Generate preview diff
+    const preview = createTwoFilesPatch("current", "updated", source, current);
+    return {
+        description: current,
+        changes: totalChanges,
+        summary,
+        preview,
+    };
+}
+/**
+ * Apply a unified diff patch to source text.
+ * Delegates to the `diff` library's applyPatch.
+ */
+export function applyUnifiedDiff(source, patch) {
+    // Validate the patch can be parsed first
+    const parsed = parsePatch(patch);
+    if (parsed.length === 0 || parsed.every((p) => p.hunks.length === 0)) {
+        throw new Error("Could not parse unified diff: no valid hunks found. " +
+            "Expected format: '--- old\\n+++ new\\n@@ -line,count +line,count @@\\n context\\n-old\\n+new\\n'");
+    }
+    const result = applyPatch(source, patch);
+    if (result === false) {
+        throw new Error("Unified diff could not be applied to the current issue description. " +
+            "The diff context may not match. Use 'dry_run: true' to debug.");
+    }
+    // Detect no-op: patch applied but nothing changed
+    if (result === source) {
+        throw new Error("Unified diff applied but did not change the issue description. " +
+            "The source text already matches the patched result.");
+    }
+    const changes = parsed.reduce((sum, p) => sum + p.hunks.reduce((hSum, h) => hSum + h.lines.filter((l) => l.startsWith("-") || l.startsWith("+")).length, 0), 0);
+    // Generate preview of what actually changed
+    const preview = createTwoFilesPatch("current", "updated", source, result);
+    // Build summary from hunk headers
+    const summaryLines = [];
+    for (const p of parsed) {
+        for (const hunk of p.hunks) {
+            const added = hunk.lines.filter((l) => l.startsWith("+")).length;
+            const removed = hunk.lines.filter((l) => l.startsWith("-")).length;
+            summaryLines.push(`Hunk at line ${hunk.oldStart}: ${removed} removed, ${added} added`);
+        }
+    }
+    return {
+        description: result,
+        changes,
+        summary: summaryLines.join("\n"),
+        preview,
+    };
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen) + "...";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.1.10",
+  "version": "2.1.12",
   "mcpName": "io.github.zereight/gitlab-mcp",
   "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
   "keywords": [
@@ -51,7 +51,7 @@
     "changelog": "auto-changelog -p",
     "test": "npm run test:all",
     "test:all": "npm run build && npm run test:mock && npm run test:live",
-    "test:mock": "node --import tsx/esm --test test/remote-auth-simple-test.ts && node --import tsx/esm --test test/mcp-oauth-tests.ts && node --import tsx/esm --test test/streamable-http-static-token-auth.test.ts && tsx test/oauth-tests.ts && tsx test/test-list-merge-requests.ts && tsx test/test-list-project-members.ts && tsx test/test-download-attachment.ts && node --import tsx/esm --test test/test-job-artifacts.ts && node --import tsx/esm --test test/test-deployment-tools.ts && node --import tsx/esm --test test/test-merge-request-approval-state-tools.ts && node --import tsx/esm --test test/test-search-code.ts && node --import tsx/esm --test test/test-tags.ts && node --import tsx/esm --test test/test-toolset-filtering.ts && node --import tsx/esm --test test/test-ci-lint.ts && node --import tsx/esm --test test/test-todos.ts && node --import tsx/esm --test test/test-auth-retry.ts && node --import tsx/esm --test 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:mock": "node --import tsx/esm --test test/remote-auth-simple-test.ts && node --import tsx/esm --test test/mcp-oauth-tests.ts && node --import tsx/esm --test test/streamable-http-static-token-auth.test.ts && tsx test/oauth-tests.ts && tsx test/test-list-merge-requests.ts && node --import tsx/esm --test test/test-merge-request-pipelines.ts && tsx test/test-list-project-members.ts && tsx test/test-download-attachment.ts && node --import tsx/esm --test test/test-job-artifacts.ts && node --import tsx/esm --test test/test-deployment-tools.ts && node --import tsx/esm --test test/test-merge-request-approval-state-tools.ts && node --import tsx/esm --test test/test-search-code.ts && node --import tsx/esm --test test/test-tags.ts && node --import tsx/esm --test test/test-toolset-filtering.ts && node --import tsx/esm --test test/test-ci-lint.ts && node --import tsx/esm --test test/test-todos.ts && node --import tsx/esm --test test/test-auth-retry.ts && node --import tsx/esm --test test/test-issue-description-patch.ts && node --import tsx/esm --test 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": "npm run build && node --import tsx/esm --test 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:mcp-oauth": "npm run build && node --import tsx/esm --test test/mcp-oauth-tests.ts",
     "test:live": "node test/validate-api.js",
@@ -70,6 +70,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.2",
     "@types/node-fetch": "^2.6.12",
+    "diff": "^9.0.0",
     "express": "^5.1.0",
     "fetch-cookie": "^3.1.0",
     "form-data": "^4.0.0",