@zereight/mcp-gitlab 1.0.33 → 1.0.35

package/README.md

@@ -51,9 +51,9 @@ When using with the Claude App, you need to set up your API key and URLs directl
 7. `create_merge_request` - Create a new merge request in a GitLab project
 8. `fork_repository` - Fork a GitLab project to your account or specified namespace
 9. `create_branch` - Create a new branch in a GitLab project
-10. `get_merge_request` - Get details of a merge request
-11. `get_merge_request_diffs` - Get the changes/diffs of a merge request
-12. `update_merge_request` - Update a merge request
+10. `get_merge_request` - Get details of a merge request (Either mergeRequestIid or branchName must be provided)
+11. `get_merge_request_diffs` - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)
+12. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)
 13. `create_note` - Create a new note (comment) to an issue or merge request
 14. `mr_discussions` - List discussion items for a merge request
 15. `update_merge_request_note` - Modify an existing merge request thread note
@@ -81,4 +81,5 @@ When using with the Claude App, you need to set up your API key and URLs directl
 37. `create_wiki_page` - Create a new wiki page in a GitLab project
 38. `update_wiki_page` - Update an existing wiki page in a GitLab project
 39. `delete_wiki_page` - Delete a wiki page from a GitLab project
+40. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
 <!-- TOOLS-END -->

package/build/index.js

@@ -17,7 +17,7 @@ import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLab
 // Discussion Schemas
 GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, UpdateMergeRequestNoteSchema, // Added
-ListMergeRequestDiscussionsSchema, } from "./schemas.js";
+ListMergeRequestDiscussionsSchema, GitLabTreeItemSchema, GetRepositoryTreeSchema, } from "./schemas.js";
 /**
  * Read version from package.json
  */
@@ -280,6 +280,11 @@ const allTools = [
         description: "Delete a wiki page from a GitLab project",
         inputSchema: zodToJsonSchema(DeleteWikiPageSchema),
     },
+    {
+        name: "get_repository_tree",
+        description: "Get the repository tree for a GitLab project (list files and directories)",
+        inputSchema: zodToJsonSchema(GetRepositoryTreeSchema),
+    },
 ];
 // Define which tools are read-only
 const readOnlyTools = [
@@ -1401,6 +1406,41 @@ async function deleteWikiPage(projectId, slug) {
     });
     await handleGitLabError(response);
 }
+/**
+ * Get the repository tree for a project
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {GetRepositoryTreeOptions} options - Options for the tree
+ * @returns {Promise<GitLabTreeItem[]>}
+ */
+async function getRepositoryTree(options) {
+    const queryParams = new URLSearchParams();
+    if (options.path)
+        queryParams.append("path", options.path);
+    if (options.ref)
+        queryParams.append("ref", options.ref);
+    if (options.recursive)
+        queryParams.append("recursive", "true");
+    if (options.per_page)
+        queryParams.append("per_page", options.per_page.toString());
+    if (options.page_token)
+        queryParams.append("page_token", options.page_token);
+    if (options.pagination)
+        queryParams.append("pagination", options.pagination);
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(options.project_id)}/repository/tree?${queryParams.toString()}`, {
+        headers: {
+            Authorization: `Bearer ${GITLAB_PERSONAL_ACCESS_TOKEN}`,
+            "Content-Type": "application/json",
+        },
+    });
+    if (response.status === 404) {
+        throw new Error("Repository or path not found");
+    }
+    if (!response.ok) {
+        throw new Error(`Failed to get repository tree: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return z.array(GitLabTreeItemSchema).parse(data);
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     // Apply read-only filter first
     const tools0 = GITLAB_READ_ONLY_MODE
@@ -1803,6 +1843,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "get_repository_tree": {
+                const args = GetRepositoryTreeSchema.parse(request.params.arguments);
+                const tree = await getRepositoryTree(args);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(tree, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${request.params.name}`);
         }

package/build/schemas.js

@@ -146,16 +146,37 @@ export const FileOperationSchema = z.object({
     content: z.string(),
 });
 // Tree and commit schemas
-export const GitLabTreeEntrySchema = z.object({
-    id: z.string(), // Changed from sha to match GitLab API
+export const GitLabTreeItemSchema = z.object({
+    id: z.string(),
     name: z.string(),
-    type: z.enum(["blob", "tree"]),
+    type: z.enum(["tree", "blob"]),
     path: z.string(),
     mode: z.string(),
 });
+export const GetRepositoryTreeSchema = z.object({
+    project_id: z.string().describe("The ID or URL-encoded path of the project"),
+    path: z.string().optional().describe("The path inside the repository"),
+    ref: z
+        .string()
+        .optional()
+        .describe("The name of a repository branch or tag. Defaults to the default branch."),
+    recursive: z
+        .boolean()
+        .optional()
+        .describe("Boolean value to get a recursive tree"),
+    per_page: z
+        .number()
+        .optional()
+        .describe("Number of results to show per page"),
+    page_token: z
+        .string()
+        .optional()
+        .describe("The tree record ID for pagination"),
+    pagination: z.string().optional().describe("Pagination method (keyset)"),
+});
 export const GitLabTreeSchema = z.object({
     id: z.string(), // Changed from sha to match GitLab API
-    tree: z.array(GitLabTreeEntrySchema),
+    tree: z.array(GitLabTreeItemSchema),
 });
 export const GitLabCommitSchema = z.object({
     id: z.string(), // Changed from sha to match GitLab API
@@ -768,9 +789,7 @@ export const ListLabelsSchema = z.object({
 });
 export const GetLabelSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    label_id: z
-        .union([z.number(), z.string()])
-        .describe("The ID or title of a project's label"),
+    label_id: z.string().describe("The ID or title of a project's label"),
     include_ancestor_groups: z
         .boolean()
         .optional()
@@ -791,9 +810,7 @@ export const CreateLabelSchema = z.object({
 });
 export const UpdateLabelSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    label_id: z
-        .union([z.number(), z.string()])
-        .describe("The ID or title of a project's label"),
+    label_id: z.string().describe("The ID or title of a project's label"),
     new_name: z.string().optional().describe("The new name of the label"),
     color: z
         .string()
@@ -811,9 +828,7 @@ export const UpdateLabelSchema = z.object({
 });
 export const DeleteLabelSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    label_id: z
-        .union([z.number(), z.string()])
-        .describe("The ID or title of a project's label"),
+    label_id: z.string().describe("The ID or title of a project's label"),
 });
 // Group projects schema
 export const ListGroupProjectsSchema = z.object({

package/package.json

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