@zereight/mcp-gitlab 2.0.36 → 2.1.1

package/build/utils/helpers.js

@@ -0,0 +1,57 @@
+/**
+ * Estimate the number of merge commits that will be added based on the merge method.
+ */
+export function estimateMergeCommitCount(mergeMethod, sourceCommitCount) {
+    if (sourceCommitCount === 0) {
+        return 0;
+    }
+    if (mergeMethod === "merge") {
+        return 1;
+    }
+    if (mergeMethod === "ff" || mergeMethod === "rebase_merge") {
+        return 0;
+    }
+    return null;
+}
+/**
+ * Summarize webhook events by stripping heavy payload fields.
+ */
+export function summarizeWebhookEvents(events) {
+    return events.map(event => ({
+        id: event.id,
+        url: event.url,
+        trigger: event.trigger,
+        response_status: event.response_status,
+        execution_duration: event.execution_duration,
+    }));
+}
+/**
+ * Filter MR diffs by excluding files matching regex patterns.
+ *
+ * @param diffs - Array of diff objects with new_path property
+ * @param excludedFilePatterns - Array of regex patterns to exclude
+ * @returns Filtered array of diffs
+ */
+export function filterDiffsByPatterns(diffs, excludedFilePatterns) {
+    if (!excludedFilePatterns?.length)
+        return diffs;
+    const regexPatterns = excludedFilePatterns
+        .map(pattern => {
+        try {
+            return new RegExp(pattern);
+        }
+        catch (e) {
+            console.warn(`Invalid regex pattern ignored: ${pattern}`);
+            return null;
+        }
+    })
+        .filter((regex) => regex !== null);
+    if (regexPatterns.length === 0)
+        return diffs;
+    const matchesAnyPattern = (path) => {
+        if (!path)
+            return false;
+        return regexPatterns.some(regex => regex.test(path));
+    };
+    return diffs.filter(diff => !matchesAnyPattern(diff.new_path));
+}

package/build/utils/schema.js

@@ -0,0 +1,49 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+/**
+ * Convert a Zod schema to JSON Schema, fixing nullable/optional fields
+ * so they are not marked as required.
+ */
+export const toJSONSchema = (schema) => {
+    const jsonSchema = zodToJsonSchema(schema, { $refStrategy: "none" });
+    // Post-process to fix nullable/optional fields and strip verbose keys
+    function fixNullableOptional(obj) {
+        if (obj && typeof obj === "object") {
+            // Strip $schema (meta-only, not needed for tool input validation)
+            delete obj.$schema;
+            // Strip additionalProperties (MCP clients ignore it, saves tokens)
+            delete obj.additionalProperties;
+            // If this object has properties, process them
+            if (obj.properties) {
+                const requiredSet = new Set(obj.required || []);
+                Object.keys(obj.properties).forEach(key => {
+                    const prop = obj.properties[key];
+                    // Handle fields that can be null or omitted
+                    // If a property has type: ["object", "null"] or anyOf with null, it should not be required
+                    if (prop.anyOf && prop.anyOf.some((t) => t.type === "null")) {
+                        requiredSet.delete(key);
+                    }
+                    else if (Array.isArray(prop.type) && prop.type.includes("null")) {
+                        requiredSet.delete(key);
+                    }
+                    // Recursively process nested objects
+                    obj.properties[key] = fixNullableOptional(prop);
+                });
+                // Normalize the required array after processing all properties
+                if (requiredSet.size > 0) {
+                    obj.required = Array.from(requiredSet);
+                }
+                else if (Object.prototype.hasOwnProperty.call(obj, "required")) {
+                    delete obj.required;
+                }
+            }
+            // Process anyOf/allOf/oneOf
+            ["anyOf", "allOf", "oneOf"].forEach(combiner => {
+                if (obj[combiner]) {
+                    obj[combiner] = obj[combiner].map(fixNullableOptional);
+                }
+            });
+        }
+        return obj;
+    }
+    return fixNullableOptional(jsonSchema);
+};

package/build/utils/url.js

@@ -0,0 +1,19 @@
+/**
+ * Smart URL handling for GitLab API
+ *
+ * @param {string | undefined} url - Input GitLab API URL
+ * @returns {string} Normalized GitLab API URL with /api/v4 path
+ */
+export function normalizeGitLabApiUrl(url) {
+    if (!url) {
+        return "https://gitlab.com/api/v4";
+    }
+    let normalizedUrl = url.trim();
+    if (normalizedUrl.endsWith("/")) {
+        normalizedUrl = normalizedUrl.slice(0, -1);
+    }
+    if (!normalizedUrl.endsWith("/api/v4")) {
+        normalizedUrl = `${normalizedUrl}/api/v4`;
+    }
+    return normalizedUrl;
+}

package/package.json

@@ -1,7 +1,26 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.0.36",
-  "description": "MCP server for using the GitLab API",
+  "version": "2.1.1",
+  "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
+  "keywords": [
+    "gitlab",
+    "gitlab-mcp",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "gitlab-api",
+    "claude",
+    "cursor",
+    "vscode",
+    "copilot",
+    "ai-agent",
+    "merge-requests",
+    "pipelines",
+    "oauth",
+    "stdio",
+    "sse",
+    "streamable-http"
+  ],
   "license": "MIT",
   "author": "zereight",
   "type": "module",
@@ -29,10 +48,10 @@
     "changelog": "auto-changelog -p",
     "test": "npm run test:all",
     "test:all": "npm run build && npm run test:mock && npm run test:live",
-    "test:mock": "npx tsx --test test/remote-auth-simple-test.ts && npx tsx --test test/mcp-oauth-tests.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 && tsx --test test/test-job-artifacts.ts && tsx --test test/test-deployment-tools.ts && tsx --test test/test-merge-request-approval-state-tools.ts && npx tsx --test test/test-search-code.ts && npx tsx --test test/test-toolset-filtering.ts",
-    "test:mcp-oauth": "npm run build && npx tsx --test test/mcp-oauth-tests.ts",
+    "test:mock": "node --import tsx/esm --test test/remote-auth-simple-test.ts && node --import tsx/esm --test test/mcp-oauth-tests.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-toolset-filtering.ts && node --import tsx/esm --test test/test-auth-retry.ts",
+    "test:mcp-oauth": "npm run build && node --import tsx/esm --test test/mcp-oauth-tests.ts",
     "test:live": "node test/validate-api.js",
-    "test:remote-auth": "npm run build && npx tsx --test test/remote-auth-simple-test.ts",
+    "test:remote-auth": "npm run build && node --import tsx/esm --test test/remote-auth-simple-test.ts",
     "test:schema": "tsx test/schema-tests.ts",
     "test:oauth": "tsx test/oauth-tests.ts",
     "test:list-merge-requests": "npm run build && tsx test/test-list-merge-requests.ts",