@zereight/mcp-gitlab 1.0.32 → 1.0.34

package/README.md

@@ -23,7 +23,8 @@ When using with the Claude App, you need to set up your API key and URLs directl
       "env": {
         "GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token",
         "GITLAB_API_URL": "your_gitlab_api_url",
-        "GITLAB_READ_ONLY_MODE": "true"
+        "GITLAB_READ_ONLY_MODE": "false",
+        "USE_GITLAB_WIKI":"true"
       }
     }
   }
@@ -36,242 +37,48 @@ When using with the Claude App, you need to set up your API key and URLs directl
 - `GITLAB_PERSONAL_ACCESS_TOKEN`: Your GitLab personal access token.
 - `GITLAB_API_URL`: Your GitLab API URL. (Default: `https://gitlab.com/api/v4`)
 - `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.
+- `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.
 
 ## Tools 🛠️
 
-1. `create_or_update_file`
-
-   - Create or update a single file in a GitLab project. 📝
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `file_path` (string): Path to create/update the file
-     - `content` (string): File content
-     - `commit_message` (string): Commit message
-     - `branch` (string): Branch to create/update the file in
-     - `previous_path` (optional string): Previous file path when renaming a file
-   - Returns: File content and commit details
-
-2. `push_files`
-
-   - Push multiple files in a single commit. 📤
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `branch` (string): Branch to push to
-     - `files` (array): Array of files to push, each with `file_path` and `content` properties
-     - `commit_message` (string): Commit message
-   - Returns: Updated branch reference
-
-3. `search_repositories`
-
-   - Search for GitLab projects. 🔍
-   - Inputs:
-     - `search` (string): Search query
-     - `page` (optional number): Page number (default: 1)
-     - `per_page` (optional number): Results per page (default: 20, max: 100)
-   - Returns: Project search results
-
-4. `create_repository`
-
-   - Create a new GitLab project. ➕
-   - Inputs:
-     - `name` (string): Project name
-     - `description` (optional string): Project description
-     - `visibility` (optional string): Project visibility level (public, private, internal)
-     - `initialize_with_readme` (optional boolean): Initialize with README
-   - Returns: Details of the created project
-
-5. `get_file_contents`
-
-   - Get the contents of a file or directory. 📂
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `file_path` (string): Path to the file/directory
-     - `ref` (optional string): Branch, tag, or commit SHA (default: default branch)
-   - Returns: File/directory content
-
-6. `create_issue`
-
-   - Create a new issue. 🐛
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `title` (string): Issue title
-     - `description` (string): Issue description
-     - `assignee_ids` (optional number[]): Array of assignee IDs
-     - `milestone_id` (optional number): Milestone ID
-     - `labels` (optional string[]): Array of labels
-   - Returns: Details of the created issue
-
-7. `create_merge_request`
-
-   - Create a new merge request. 🚀
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `title` (string): Merge request title
-     - `description` (string): Merge request description
-     - `source_branch` (string): Branch with changes
-     - `target_branch` (string): Branch to merge into
-     - `allow_collaboration` (optional boolean): Allow collaborators to push commits to the source branch
-     - `draft` (optional boolean): Create as a draft merge request
-   - Returns: Details of the created merge request
-
-8. `fork_repository`
-
-   - Fork a project. 🍴
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path to fork
-     - `namespace` (optional string): Namespace to fork into (default: user namespace)
-   - Returns: Details of the forked project
-
-9. `create_branch`
-
-   - Create a new branch. 🌿
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `name` (string): New branch name
-     - `ref` (optional string): Ref to create the branch from (branch, tag, commit SHA, default: default branch)
-   - Returns: Created branch reference
-
-10. `get_merge_request`
-
-    - Get details of a merge request. ℹ️
-    - Inputs:
-      - `project_id` (string): Project ID or namespace/project_path
-      - `merge_request_iid` (number): Merge request IID
-    - Returns: Merge request details
-
-11. `get_merge_request_diffs`
-
-    - Get changes (diffs) of a merge request. diff
-    - Inputs:
-      - `project_id` (string): Project ID or namespace/project_path
-      - `merge_request_iid` (number): Merge request IID
-      - `view` (optional string): Diff view type ('inline' or 'parallel')
-    - Returns: Array of merge request diff information
-
-12. `update_merge_request`
-
-    - Update a merge request. 🔄
-    - Inputs:
-      - `project_id` (string): Project ID or namespace/project_path
-      - `merge_request_iid` (number): Merge request IID
-      - `title` (optional string): New title
-      - `description` (string): New description
-      - `target_branch` (optional string): New target branch
-      - `state_event` (optional string): Merge request state change event ('close', 'reopen')
-      - `remove_source_branch` (optional boolean): Remove source branch after merge
-      - `allow_collaboration` (optional boolean): Allow collaborators to push commits to the source branch
-    - Returns: Updated merge request details
-
-13. `create_note`
-    - Create a new note (comment) to an issue or merge request. 💬
-    - Inputs:
-      - `project_id` (string): Project ID or namespace/project_path
-      - `noteable_type` (string): Type of noteable ("issue" or "merge_request")
-      - `noteable_iid` (number): IID of the issue or merge request
-      - `body` (string): Note content
-    - Returns: Details of the created note
-
-14. `list_projects`
-    - List accessible projects with rich filtering options 📊
-    - Inputs:
-      - Search/filtering:
-        - `search`
-        - `owned`
-        - `membership`
-        - `archived`
-        - `visibility`
-      - Features filtering:
-        - `with_issues_enabled`
-        - `with_merge_requests_enabled`
-      - Sorting:
-        - `order_by`
-        - `sort`
-      - Access control:
-        - `min_access_level`
-      - Pagination:
-        - `page`
-        - `per_page`
-        - `simple`
-    - Returns: Array of projects 
-15. `list_labels`
-    - List all labels for a project with filtering options 🏷️
-    - Inputs:
-      - `project_id` (string): Project ID or path
-      - `with_counts` (optional): Include issue and merge request counts
-      - `include_ancestor_groups` (optional): Include ancestor groups
-      - `search` (optional): Filter labels by keyword
-    - Returns: Array of labels
-16. `get_label`
-    - Get a single label from a project
-    - Inputs:
-      -  `project_id` (string): Project ID or path
-      - `label_id` (number/string): Label ID or name
-      - `include_ancestor_groups` (optional): Include ancestor groups 
-    - Returns: label details
-17. `create_label`
-    - Create a new label in an object 🏷️➕
-    - Inputs:
-      - `project_id` (string): Project ID or path
-      - `name` (string): Label name
-      - `color` (string): Color in hex format (e.g., "#FF0000")
-      - `description` (optional): Label description
-      - `priority` (optional): Label priority
-    - Returns: Created label details
-18. `update_label`
-    - Update an existing label in a project 🏷️✏️
-    - Inputs:
-      - `project_id` (string): Project ID or path
-      - `label_id` (number/string): Label ID or name
-      - `new_name` (optional): New label name
-      - `color` (optional): New color in hex format
-      - `description` (optional): New description
-      - `priority` (optional): New priority
-    - Returns: Updated label details
-19. `delete_label`
-    - Delete a label from a project 🏷️❌
-    - Inputs:
-      - `project_id` (string): Project ID or path
-      - `label_id` (number/string): Label ID or name
-    - Returns: Success message
-
-14. `list_group_projects`
-
-    - List all projects in a GitLab group. 📂
-    - Inputs:
-      - `group_id` (string): Project ID or namespace/project_path
-      - Filtering options:
-        - `include_subgroups` (optional boolean): Include projects from subgroups
-        - `search` (optional string): Search term to filter projects
-        - `archived` (optional boolean): Filter for archived projects
-        - `visibility` (optional string): Filter by project visibility (public/internal/private)
-        - `with_programming_language` (optional string): Filter by programming language
-        - `starred` (optional boolean): Filter by starred projects
-      - Feature filtering:
-        - `with_issues_enabled` (optional boolean): Filter projects with issues feature enabled
-        - `with_merge_requests_enabled` (optional boolean): Filter projects with merge requests feature enabled
-        - `min_access_level` (optional number): Filter by minimum access level
-      - Pagination:
-        - `page` (optional number): Page number
-        - `per_page` (optional number): Results per page
-      - Sorting:
-        - `order_by` (optional string): Field to sort by
-        - `sort` (optional string): Sort direction (asc/desc)
-      - Additional data:
-        - `statistics` (optional boolean): Include project statistics
-        - `with_custom_attributes` (optional boolean): Include custom attributes
-        - `with_security_reports` (optional boolean): Include security reports
-    - Returns: List of projects
-
-## Environment Variable Configuration
-
-Before running the server, you need to set the following environment variables:
-
-```
-GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token
-GITLAB_API_URL=your_gitlab_api_url  # Default: https://gitlab.com/api/v4
-GITLAB_READ_ONLY_MODE=true          # Optional: Enable read-only mode
-```
-
-## License
-
-MIT License
++<!-- TOOLS-START -->
+1. `create_or_update_file` - Create or update a single file in a GitLab project
+2. `search_repositories` - Search for GitLab projects
+3. `create_repository` - Create a new GitLab project
+4. `get_file_contents` - Get the contents of a file or directory from a GitLab project
+5. `push_files` - Push multiple files to a GitLab project in a single commit
+6. `create_issue` - Create a new issue in a GitLab project
+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
+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
+16. `list_issues` - List issues in a GitLab project with filtering options
+17. `get_issue` - Get details of a specific issue in a GitLab project
+18. `update_issue` - Update an issue in a GitLab project
+19. `delete_issue` - Delete an issue from a GitLab project
+20. `list_issue_links` - List all issue links for a specific issue
+21. `get_issue_link` - Get a specific issue link
+22. `create_issue_link` - Create an issue link between two issues
+23. `delete_issue_link` - Delete an issue link
+24. `list_namespaces` - List all namespaces available to the current user
+25. `get_namespace` - Get details of a namespace by ID or path
+26. `verify_namespace` - Verify if a namespace path exists
+27. `get_project` - Get details of a specific project
+28. `list_projects` - List projects accessible by the current user
+29. `list_labels` - List labels for a project
+30. `get_label` - Get a single label from a project
+31. `create_label` - Create a new label in a project
+32. `update_label` - Update an existing label in a project
+33. `delete_label` - Delete a label from a project
+34. `list_group_projects` - List projects in a GitLab group with filtering options
+35. `list_wiki_pages` - List wiki pages in a GitLab project
+36. `get_wiki_page` - Get details of a specific wiki page
+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
+<!-- TOOLS-END -->

package/build/index.js

@@ -3,21 +3,21 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import fetch from "node-fetch";
-import { SocksProxyAgent } from 'socks-proxy-agent';
-import { HttpsProxyAgent } from 'https-proxy-agent';
-import { HttpProxyAgent } from 'http-proxy-agent';
+import { SocksProxyAgent } from "socks-proxy-agent";
+import { HttpsProxyAgent } from "https-proxy-agent";
+import { HttpProxyAgent } from "http-proxy-agent";
 import { z } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { fileURLToPath } from "url";
 import { dirname } from "path";
 import fs from "fs";
 import path from "path";
-import { URL } from 'url';
+import { URL } from "url";
 import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabIssueSchema, GitLabMergeRequestSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabSearchResponseSchema, GitLabTreeSchema, GitLabCommitSchema, GitLabNamespaceSchema, GitLabNamespaceExistsResponseSchema, GitLabProjectSchema, CreateOrUpdateFileSchema, SearchRepositoriesSchema, CreateRepositorySchema, GetFileContentsSchema, PushFilesSchema, CreateIssueSchema, CreateMergeRequestSchema, ForkRepositorySchema, CreateBranchSchema, GitLabMergeRequestDiffSchema, GetMergeRequestSchema, GetMergeRequestDiffsSchema, UpdateMergeRequestSchema, ListIssuesSchema, GetIssueSchema, UpdateIssueSchema, DeleteIssueSchema, GitLabIssueLinkSchema, GitLabIssueWithLinkDetailsSchema, ListIssueLinksSchema, GetIssueLinkSchema, CreateIssueLinkSchema, DeleteIssueLinkSchema, ListNamespacesSchema, GetNamespaceSchema, VerifyNamespaceSchema, GetProjectSchema, ListProjectsSchema, ListLabelsSchema, GetLabelSchema, CreateLabelSchema, UpdateLabelSchema, DeleteLabelSchema, CreateNoteSchema, ListGroupProjectsSchema, ListWikiPagesSchema, GetWikiPageSchema, CreateWikiPageSchema, UpdateWikiPageSchema, DeleteWikiPageSchema, GitLabWikiPageSchema, 
 // Discussion Schemas
 GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, UpdateMergeRequestNoteSchema, // Added
-ListMergeRequestDiscussionsSchema, } from "./schemas.js";
+ListMergeRequestDiscussionsSchema, GitLabTreeItemSchema, GetRepositoryTreeSchema, } from "./schemas.js";
 /**
  * Read version from package.json
  */
@@ -52,7 +52,7 @@ const HTTPS_PROXY = process.env.HTTPS_PROXY;
 let httpAgent = undefined;
 let httpsAgent = undefined;
 if (HTTP_PROXY) {
-    if (HTTP_PROXY.startsWith('socks')) {
+    if (HTTP_PROXY.startsWith("socks")) {
         httpAgent = new SocksProxyAgent(HTTP_PROXY);
     }
     else {
@@ -60,7 +60,7 @@ if (HTTP_PROXY) {
     }
 }
 if (HTTPS_PROXY) {
-    if (HTTPS_PROXY.startsWith('socks')) {
+    if (HTTPS_PROXY.startsWith("socks")) {
         httpsAgent = new SocksProxyAgent(HTTPS_PROXY);
     }
     else {
@@ -77,11 +77,11 @@ const DEFAULT_HEADERS = {
 const DEFAULT_FETCH_CONFIG = {
     headers: DEFAULT_HEADERS,
     agent: (parsedUrl) => {
-        if (parsedUrl.protocol === 'https:') {
+        if (parsedUrl.protocol === "https:") {
             return httpsAgent;
         }
         return httpAgent;
-    }
+    },
 };
 // Define all available tools
 const allTools = [
@@ -132,17 +132,17 @@ const allTools = [
     },
     {
         name: "get_merge_request",
-        description: "Get details of a merge request",
+        description: "Get details of a merge request (Either mergeRequestIid or branchName must be provided)",
         inputSchema: zodToJsonSchema(GetMergeRequestSchema),
     },
     {
         name: "get_merge_request_diffs",
-        description: "Get the changes/diffs of a merge request",
+        description: "Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)",
         inputSchema: zodToJsonSchema(GetMergeRequestDiffsSchema),
     },
     {
         name: "update_merge_request",
-        description: "Update a merge request",
+        description: "Update a merge request (Either mergeRequestIid or branchName must be provided)",
         inputSchema: zodToJsonSchema(UpdateMergeRequestSchema),
     },
     {
@@ -279,7 +279,12 @@ const allTools = [
         name: "delete_wiki_page",
         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 = [
@@ -347,7 +352,8 @@ async function handleGitLabError(response) {
     if (!response.ok) {
         const errorBody = await response.text();
         // Check specifically for Rate Limit error
-        if (response.status === 403 && errorBody.includes("User API Key Rate limit exceeded")) {
+        if (response.status === 403 &&
+            errorBody.includes("User API Key Rate limit exceeded")) {
             console.error("GitLab API Rate Limit Exceeded:", errorBody);
             console.log("User API Key Rate limit exceeded. Please try again later.");
             throw new Error(`GitLab API Rate Limit Exceeded: ${errorBody}`);
@@ -937,27 +943,50 @@ async function createRepository(options) {
  * MR 조회 함수 (Function to retrieve merge request)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
- * @param {number} mergeRequestIid - The internal ID of the merge request
+ * @param {number} mergeRequestIid - The internal ID of the merge request (Optional)
+ * @param {string} [branchName] - The name of the branch to search for merge request by branch name (Optional)
  * @returns {Promise<GitLabMergeRequest>} The merge request details
  */
-async function getMergeRequest(projectId, mergeRequestIid) {
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}`);
+async function getMergeRequest(projectId, mergeRequestIid, branchName) {
+    let url;
+    if (mergeRequestIid) {
+        url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}`);
+    }
+    else if (branchName) {
+        url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests?source_branch=${encodeURIComponent(branchName)}`);
+    }
+    else {
+        throw new Error("Either mergeRequestIid or branchName must be provided");
+    }
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
     await handleGitLabError(response);
-    return GitLabMergeRequestSchema.parse(await response.json());
+    const data = await response.json();
+    // If response is an array (Comes from branchName search), return the first item if exist
+    if (Array.isArray(data) && data.length > 0) {
+        return GitLabMergeRequestSchema.parse(data[0]);
+    }
+    return GitLabMergeRequestSchema.parse(data);
 }
 /**
  * Get merge request changes/diffs
  * MR 변경사항 조회 함수 (Function to retrieve merge request changes)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
- * @param {number} mergeRequestIid - The internal ID of the merge request
+ * @param {number} mergeRequestIid - The internal ID of the merge request (Either mergeRequestIid or branchName must be provided)
+ * @param {string} [branchName] - The name of the branch to search for merge request by branch name (Either mergeRequestIid or branchName must be provided)
  * @param {string} [view] - The view type for the diff (inline or parallel)
  * @returns {Promise<GitLabMergeRequestDiff[]>} The merge request diffs
  */
-async function getMergeRequestDiffs(projectId, mergeRequestIid, view) {
+async function getMergeRequestDiffs(projectId, mergeRequestIid, branchName, view) {
+    if (!mergeRequestIid && !branchName) {
+        throw new Error("Either mergeRequestIid or branchName must be provided");
+    }
+    if (branchName && !mergeRequestIid) {
+        const mergeRequest = await getMergeRequest(projectId, undefined, branchName);
+        mergeRequestIid = mergeRequest.iid;
+    }
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/changes`);
     if (view) {
         url.searchParams.append("view", view);
@@ -974,11 +1003,19 @@ async function getMergeRequestDiffs(projectId, mergeRequestIid, view) {
  * MR 업데이트 함수 (Function to update merge request)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
- * @param {number} mergeRequestIid - The internal ID of the merge request
+ * @param {number} mergeRequestIid - The internal ID of the merge request (Optional)
+ * @param {string} branchName - The name of the branch to search for merge request by branch name (Optional)
  * @param {Object} options - The update options
  * @returns {Promise<GitLabMergeRequest>} The updated merge request
  */
-async function updateMergeRequest(projectId, mergeRequestIid, options) {
+async function updateMergeRequest(projectId, options, mergeRequestIid, branchName) {
+    if (!mergeRequestIid && !branchName) {
+        throw new Error("Either mergeRequestIid or branchName must be provided");
+    }
+    if (branchName && !mergeRequestIid) {
+        const mergeRequest = await getMergeRequest(projectId, undefined, branchName);
+        mergeRequestIid = mergeRequest.iid;
+    }
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -1304,9 +1341,9 @@ async function listGroupProjects(options) {
 async function listWikiPages(projectId, options = {}) {
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis`);
     if (options.page)
-        url.searchParams.append('page', options.page.toString());
+        url.searchParams.append("page", options.page.toString());
     if (options.per_page)
-        url.searchParams.append('per_page', options.per_page.toString());
+        url.searchParams.append("per_page", options.per_page.toString());
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -1332,7 +1369,7 @@ async function createWikiPage(projectId, title, content, format) {
         body.format = format;
     const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis`, {
         ...DEFAULT_FETCH_CONFIG,
-        method: 'POST',
+        method: "POST",
         body: JSON.stringify(body),
     });
     await handleGitLabError(response);
@@ -1352,7 +1389,7 @@ async function updateWikiPage(projectId, slug, title, content, format) {
         body.format = format;
     const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, {
         ...DEFAULT_FETCH_CONFIG,
-        method: 'PUT',
+        method: "PUT",
         body: JSON.stringify(body),
     });
     await handleGitLabError(response);
@@ -1365,10 +1402,45 @@ async function updateWikiPage(projectId, slug, title, content, format) {
 async function deleteWikiPage(projectId, slug) {
     const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, {
         ...DEFAULT_FETCH_CONFIG,
-        method: 'DELETE',
+        method: "DELETE",
     });
     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
@@ -1493,7 +1565,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "get_merge_request": {
                 const args = GetMergeRequestSchema.parse(request.params.arguments);
-                const mergeRequest = await getMergeRequest(args.project_id, args.merge_request_iid);
+                const mergeRequest = await getMergeRequest(args.project_id, args.merge_request_iid, args.source_branch);
                 return {
                     content: [
                         { type: "text", text: JSON.stringify(mergeRequest, null, 2) },
@@ -1502,15 +1574,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "get_merge_request_diffs": {
                 const args = GetMergeRequestDiffsSchema.parse(request.params.arguments);
-                const diffs = await getMergeRequestDiffs(args.project_id, args.merge_request_iid, args.view);
+                const diffs = await getMergeRequestDiffs(args.project_id, args.merge_request_iid, args.source_branch, args.view);
                 return {
                     content: [{ type: "text", text: JSON.stringify(diffs, null, 2) }],
                 };
             }
             case "update_merge_request": {
                 const args = UpdateMergeRequestSchema.parse(request.params.arguments);
-                const { project_id, merge_request_iid, ...options } = args;
-                const mergeRequest = await updateMergeRequest(project_id, merge_request_iid, options);
+                const { project_id, merge_request_iid, source_branch, ...options } = args;
+                const mergeRequest = await updateMergeRequest(project_id, options, merge_request_iid, source_branch);
                 return {
                     content: [
                         { type: "text", text: JSON.stringify(mergeRequest, null, 2) },
@@ -1731,27 +1803,52 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "list_wiki_pages": {
                 const { project_id, page, per_page } = ListWikiPagesSchema.parse(request.params.arguments);
                 const wikiPages = await listWikiPages(project_id, { page, per_page });
-                return { content: [{ type: "text", text: JSON.stringify(wikiPages, null, 2) }] };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(wikiPages, null, 2) }],
+                };
             }
             case "get_wiki_page": {
                 const { project_id, slug } = GetWikiPageSchema.parse(request.params.arguments);
                 const wikiPage = await getWikiPage(project_id, slug);
-                return { content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }] };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }],
+                };
             }
             case "create_wiki_page": {
                 const { project_id, title, content, format } = CreateWikiPageSchema.parse(request.params.arguments);
                 const wikiPage = await createWikiPage(project_id, title, content, format);
-                return { content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }] };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }],
+                };
             }
             case "update_wiki_page": {
                 const { project_id, slug, title, content, format } = UpdateWikiPageSchema.parse(request.params.arguments);
                 const wikiPage = await updateWikiPage(project_id, slug, title, content, format);
-                return { content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }] };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }],
+                };
             }
             case "delete_wiki_page": {
                 const { project_id, slug } = DeleteWikiPageSchema.parse(request.params.arguments);
                 await deleteWikiPage(project_id, slug);
-                return { content: [{ type: "text", text: JSON.stringify({ status: "success", message: "Wiki page deleted successfully" }, null, 2) }] };
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "success",
+                                message: "Wiki page deleted successfully",
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            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

@@ -57,7 +57,8 @@ export const GitLabRepositorySchema = z.object({
     created_at: z.string().optional(),
     last_activity_at: z.string().optional(),
     default_branch: z.string().optional(),
-    namespace: z.object({
+    namespace: z
+        .object({
         id: z.number(),
         name: z.string(),
         path: z.string(),
@@ -65,7 +66,8 @@ export const GitLabRepositorySchema = z.object({
         full_path: z.string(),
         avatar_url: z.string().nullable().optional(),
         web_url: z.string().optional(),
-    }).optional(),
+    })
+        .optional(),
     readme_url: z.string().optional().nullable(),
     topics: z.array(z.string()).optional(),
     tag_list: z.array(z.string()).optional(), // deprecated but still present
@@ -73,16 +75,24 @@ export const GitLabRepositorySchema = z.object({
     archived: z.boolean().optional(),
     forks_count: z.number().optional(),
     star_count: z.number().optional(),
-    permissions: z.object({
-        project_access: z.object({
+    permissions: z
+        .object({
+        project_access: z
+            .object({
             access_level: z.number(),
             notification_level: z.number().optional(),
-        }).optional().nullable(),
-        group_access: z.object({
+        })
+            .optional()
+            .nullable(),
+        group_access: z
+            .object({
             access_level: z.number(),
             notification_level: z.number().optional(),
-        }).optional().nullable(),
-    }).optional(),
+        })
+            .optional()
+            .nullable(),
+    })
+        .optional(),
     container_registry_enabled: z.boolean().optional(),
     container_registry_access_level: z.string().optional(),
     issues_enabled: z.boolean().optional(),
@@ -93,12 +103,14 @@ export const GitLabRepositorySchema = z.object({
     can_create_merge_request_in: z.boolean().optional(),
     resolve_outdated_diff_discussions: z.boolean().optional(),
     shared_runners_enabled: z.boolean().optional(),
-    shared_with_groups: z.array(z.object({
+    shared_with_groups: z
+        .array(z.object({
         group_id: z.number(),
         group_name: z.string(),
         group_full_path: z.string(),
         group_access_level: z.number(),
-    })).optional(),
+    }))
+        .optional(),
 });
 // Project schema (extended from repository schema)
 export const GitLabProjectSchema = GitLabRepositorySchema;
@@ -134,16 +146,25 @@ 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
@@ -251,17 +272,21 @@ export const GitLabIssueSchema = z.object({
     updated_at: z.string(),
     closed_at: z.string().nullable(),
     web_url: z.string(), // Changed from html_url to match GitLab API
-    references: z.object({
+    references: z
+        .object({
         short: z.string(),
         relative: z.string(),
         full: z.string(),
-    }).optional(),
-    time_stats: z.object({
+    })
+        .optional(),
+    time_stats: z
+        .object({
         time_estimate: z.number(),
         total_time_spent: z.number(),
         human_time_estimate: z.string().nullable(),
         human_total_time_spent: z.string().nullable(),
-    }).optional(),
+    })
+        .optional(),
     confidential: z.boolean().optional(),
     due_date: z.string().nullable().optional(),
     discussion_locked: z.boolean().nullable().optional(),
@@ -270,7 +295,7 @@ export const GitLabIssueSchema = z.object({
 // NEW SCHEMA: For issue with link details (used in listing issue links)
 export const GitLabIssueWithLinkDetailsSchema = GitLabIssueSchema.extend({
     issue_link_id: z.number(),
-    link_type: z.enum(['relates_to', 'blocks', 'is_blocked_by']),
+    link_type: z.enum(["relates_to", "blocks", "is_blocked_by"]),
     link_created_at: z.string(),
     link_updated_at: z.string(),
 });
@@ -278,11 +303,13 @@ export const GitLabIssueWithLinkDetailsSchema = GitLabIssueSchema.extend({
 export const GitLabForkParentSchema = z.object({
     name: z.string(),
     path_with_namespace: z.string(), // Changed from full_name to match GitLab API
-    owner: z.object({
+    owner: z
+        .object({
         username: z.string(), // Changed from login to match GitLab API
         id: z.number(),
         avatar_url: z.string(),
-    }).optional(), // Made optional to handle cases where GitLab API doesn't include it
+    })
+        .optional(), // Made optional to handle cases where GitLab API doesn't include it
     web_url: z.string(), // Changed from html_url to match GitLab API
 });
 export const GitLabForkSchema = GitLabRepositorySchema.extend({
@@ -346,7 +373,9 @@ export const GitLabDiscussionNoteSchema = z.object({
     resolved: z.boolean().optional(),
     resolved_by: GitLabUserSchema.nullable().optional(),
     resolved_at: z.string().nullable().optional(),
-    position: z.object({
+    position: z
+        .object({
+        // Only present for DiffNote
         base_sha: z.string(),
         start_sha: z.string(),
         head_sha: z.string(),
@@ -355,7 +384,8 @@ export const GitLabDiscussionNoteSchema = z.object({
         position_type: z.enum(["text", "image", "file"]),
         old_line: z.number().nullable(),
         new_line: z.number().nullable(),
-        line_range: z.object({
+        line_range: z
+            .object({
             start: z.object({
                 line_code: z.string(),
                 type: z.enum(["new", "old"]),
@@ -368,12 +398,15 @@ export const GitLabDiscussionNoteSchema = z.object({
                 old_line: z.number().nullable(),
                 new_line: z.number().nullable(),
             }),
-        }).nullable().optional(), // For multi-line diff notes
+        })
+            .nullable()
+            .optional(), // For multi-line diff notes
         width: z.number().optional(), // For image diff notes
         height: z.number().optional(), // For image diff notes
         x: z.number().optional(), // For image diff notes
         y: z.number().optional(), // For image diff notes
-    }).optional(),
+    })
+        .optional(),
 });
 export const GitLabDiscussionSchema = z.object({
     id: z.string(),
@@ -402,10 +435,7 @@ export const CreateOrUpdateFileSchema = ProjectParamsSchema.extend({
         .string()
         .optional()
         .describe("Path of the file to move/rename"),
-    last_commit_id: z
-        .string()
-        .optional()
-        .describe("Last known file commit ID"),
+    last_commit_id: z.string().optional().describe("Last known file commit ID"),
     commit_id: z
         .string()
         .optional()
@@ -489,7 +519,9 @@ export const GitLabMergeRequestDiffSchema = z.object({
 export const GetMergeRequestSchema = ProjectParamsSchema.extend({
     merge_request_iid: z
         .number()
-        .describe("The internal ID of the merge request"),
+        .optional()
+        .describe("The IID of a merge request"),
+    source_branch: z.string().optional().describe("Source branch name"),
 });
 export const UpdateMergeRequestSchema = GetMergeRequestSchema.extend({
     title: z.string().optional().describe("The title of the merge request"),
@@ -531,22 +563,61 @@ export const CreateNoteSchema = z.object({
 // Issues API operation schemas
 export const ListIssuesSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    assignee_id: z.number().optional().describe("Return issues assigned to the given user ID"),
-    assignee_username: z.string().optional().describe("Return issues assigned to the given username"),
-    author_id: z.number().optional().describe("Return issues created by the given user ID"),
-    author_username: z.string().optional().describe("Return issues created by the given username"),
-    confidential: z.boolean().optional().describe("Filter confidential or public issues"),
-    created_after: z.string().optional().describe("Return issues created after the given time"),
-    created_before: z.string().optional().describe("Return issues created before the given time"),
-    due_date: z.string().optional().describe("Return issues that have the due date"),
+    assignee_id: z
+        .number()
+        .optional()
+        .describe("Return issues assigned to the given user ID"),
+    assignee_username: z
+        .string()
+        .optional()
+        .describe("Return issues assigned to the given username"),
+    author_id: z
+        .number()
+        .optional()
+        .describe("Return issues created by the given user ID"),
+    author_username: z
+        .string()
+        .optional()
+        .describe("Return issues created by the given username"),
+    confidential: z
+        .boolean()
+        .optional()
+        .describe("Filter confidential or public issues"),
+    created_after: z
+        .string()
+        .optional()
+        .describe("Return issues created after the given time"),
+    created_before: z
+        .string()
+        .optional()
+        .describe("Return issues created before the given time"),
+    due_date: z
+        .string()
+        .optional()
+        .describe("Return issues that have the due date"),
     label_name: z.array(z.string()).optional().describe("Array of label names"),
     milestone: z.string().optional().describe("Milestone title"),
-    scope: z.enum(['created-by-me', 'assigned-to-me', 'all']).optional().describe("Return issues from a specific scope"),
+    scope: z
+        .enum(["created-by-me", "assigned-to-me", "all"])
+        .optional()
+        .describe("Return issues from a specific scope"),
     search: z.string().optional().describe("Search for specific terms"),
-    state: z.enum(['opened', 'closed', 'all']).optional().describe("Return issues with a specific state"),
-    updated_after: z.string().optional().describe("Return issues updated after the given time"),
-    updated_before: z.string().optional().describe("Return issues updated before the given time"),
-    with_labels_details: z.boolean().optional().describe("Return more details for each label"),
+    state: z
+        .enum(["opened", "closed", "all"])
+        .optional()
+        .describe("Return issues with a specific state"),
+    updated_after: z
+        .string()
+        .optional()
+        .describe("Return issues updated after the given time"),
+    updated_before: z
+        .string()
+        .optional()
+        .describe("Return issues updated before the given time"),
+    with_labels_details: z
+        .boolean()
+        .optional()
+        .describe("Return more details for each label"),
     page: z.number().optional().describe("Page number for pagination"),
     per_page: z.number().optional().describe("Number of items per page"),
 });
@@ -559,13 +630,28 @@ export const UpdateIssueSchema = z.object({
     issue_iid: z.number().describe("The internal ID of the project issue"),
     title: z.string().optional().describe("The title of the issue"),
     description: z.string().optional().describe("The description of the issue"),
-    assignee_ids: z.array(z.number()).optional().describe("Array of user IDs to assign issue to"),
-    confidential: z.boolean().optional().describe("Set the issue to be confidential"),
-    discussion_locked: z.boolean().optional().describe("Flag to lock discussions"),
-    due_date: z.string().optional().describe("Date the issue is due (YYYY-MM-DD)"),
+    assignee_ids: z
+        .array(z.number())
+        .optional()
+        .describe("Array of user IDs to assign issue to"),
+    confidential: z
+        .boolean()
+        .optional()
+        .describe("Set the issue to be confidential"),
+    discussion_locked: z
+        .boolean()
+        .optional()
+        .describe("Flag to lock discussions"),
+    due_date: z
+        .string()
+        .optional()
+        .describe("Date the issue is due (YYYY-MM-DD)"),
     labels: z.array(z.string()).optional().describe("Array of label names"),
     milestone_id: z.number().optional().describe("Milestone ID to assign"),
-    state_event: z.enum(['close', 'reopen']).optional().describe("Update issue state (close/reopen)"),
+    state_event: z
+        .enum(["close", "reopen"])
+        .optional()
+        .describe("Update issue state (close/reopen)"),
     weight: z.number().optional().describe("Weight of the issue (0-9)"),
 });
 export const DeleteIssueSchema = z.object({
@@ -576,7 +662,7 @@ export const DeleteIssueSchema = z.object({
 export const GitLabIssueLinkSchema = z.object({
     source_issue: GitLabIssueSchema,
     target_issue: GitLabIssueSchema,
-    link_type: z.enum(['relates_to', 'blocks', 'is_blocked_by']),
+    link_type: z.enum(["relates_to", "blocks", "is_blocked_by"]),
 });
 export const ListIssueLinksSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
@@ -590,9 +676,16 @@ export const GetIssueLinkSchema = z.object({
 export const CreateIssueLinkSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
     issue_iid: z.number().describe("The internal ID of a project's issue"),
-    target_project_id: z.string().describe("The ID or URL-encoded path of a target project"),
-    target_issue_iid: z.number().describe("The internal ID of a target project's issue"),
-    link_type: z.enum(['relates_to', 'blocks', 'is_blocked_by']).optional().describe("The type of the relation, defaults to relates_to"),
+    target_project_id: z
+        .string()
+        .describe("The ID or URL-encoded path of a target project"),
+    target_issue_iid: z
+        .number()
+        .describe("The internal ID of a target project's issue"),
+    link_type: z
+        .enum(["relates_to", "blocks", "is_blocked_by"])
+        .optional()
+        .describe("The type of the relation, defaults to relates_to"),
 });
 export const DeleteIssueLinkSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
@@ -604,7 +697,10 @@ export const ListNamespacesSchema = z.object({
     search: z.string().optional().describe("Search term for namespaces"),
     page: z.number().optional().describe("Page number for pagination"),
     per_page: z.number().optional().describe("Number of items per page"),
-    owned: z.boolean().optional().describe("Filter for namespaces owned by current user"),
+    owned: z
+        .boolean()
+        .optional()
+        .describe("Filter for namespaces owned by current user"),
 });
 export const GetNamespaceSchema = z.object({
     namespace_id: z.string().describe("Namespace ID or full path"),
@@ -620,67 +716,160 @@ export const ListProjectsSchema = z.object({
     search: z.string().optional().describe("Search term for projects"),
     page: z.number().optional().describe("Page number for pagination"),
     per_page: z.number().optional().describe("Number of items per page"),
-    owned: z.boolean().optional().describe("Filter for projects owned by current user"),
-    membership: z.boolean().optional().describe("Filter for projects where current user is a member"),
+    search_namespaces: z
+        .boolean()
+        .optional()
+        .describe("Needs to be true if search is full path"),
+    owned: z
+        .boolean()
+        .optional()
+        .describe("Filter for projects owned by current user"),
+    membership: z
+        .boolean()
+        .optional()
+        .describe("Filter for projects where current user is a member"),
     simple: z.boolean().optional().describe("Return only limited fields"),
     archived: z.boolean().optional().describe("Filter for archived projects"),
-    visibility: z.enum(["public", "internal", "private"]).optional().describe("Filter by project visibility"),
-    order_by: z.enum(["id", "name", "path", "created_at", "updated_at", "last_activity_at"]).optional().describe("Return projects ordered by field"),
-    sort: z.enum(["asc", "desc"]).optional().describe("Return projects sorted in ascending or descending order"),
-    with_issues_enabled: z.boolean().optional().describe("Filter projects with issues feature enabled"),
-    with_merge_requests_enabled: z.boolean().optional().describe("Filter projects with merge requests feature enabled"),
-    min_access_level: z.number().optional().describe("Filter by minimum access level"),
+    visibility: z
+        .enum(["public", "internal", "private"])
+        .optional()
+        .describe("Filter by project visibility"),
+    order_by: z
+        .enum([
+        "id",
+        "name",
+        "path",
+        "created_at",
+        "updated_at",
+        "last_activity_at",
+    ])
+        .optional()
+        .describe("Return projects ordered by field"),
+    sort: z
+        .enum(["asc", "desc"])
+        .optional()
+        .describe("Return projects sorted in ascending or descending order"),
+    with_issues_enabled: z
+        .boolean()
+        .optional()
+        .describe("Filter projects with issues feature enabled"),
+    with_merge_requests_enabled: z
+        .boolean()
+        .optional()
+        .describe("Filter projects with merge requests feature enabled"),
+    min_access_level: z
+        .number()
+        .optional()
+        .describe("Filter by minimum access level"),
 });
 // Label operation schemas
 export const ListLabelsSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    with_counts: z.boolean().optional().describe("Whether or not to include issue and merge request counts"),
-    include_ancestor_groups: z.boolean().optional().describe("Include ancestor groups"),
+    with_counts: z
+        .boolean()
+        .optional()
+        .describe("Whether or not to include issue and merge request counts"),
+    include_ancestor_groups: z
+        .boolean()
+        .optional()
+        .describe("Include ancestor groups"),
     search: z.string().optional().describe("Keyword to filter labels by"),
 });
 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"),
-    include_ancestor_groups: z.boolean().optional().describe("Include ancestor groups"),
+    label_id: z
+        .union([z.number(), z.string()])
+        .describe("The ID or title of a project's label"),
+    include_ancestor_groups: z
+        .boolean()
+        .optional()
+        .describe("Include ancestor groups"),
 });
 export const CreateLabelSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
     name: z.string().describe("The name of the label"),
-    color: z.string().describe("The color of the label given in 6-digit hex notation with leading '#' sign"),
+    color: z
+        .string()
+        .describe("The color of the label given in 6-digit hex notation with leading '#' sign"),
     description: z.string().optional().describe("The description of the label"),
-    priority: z.number().nullable().optional().describe("The priority of the label"),
+    priority: z
+        .number()
+        .nullable()
+        .optional()
+        .describe("The priority of the label"),
 });
 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
+        .union([z.number(), 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().optional().describe("The color of the label given in 6-digit hex notation with leading '#' sign"),
-    description: z.string().optional().describe("The new description of the label"),
-    priority: z.number().nullable().optional().describe("The new priority of the label"),
+    color: z
+        .string()
+        .optional()
+        .describe("The color of the label given in 6-digit hex notation with leading '#' sign"),
+    description: z
+        .string()
+        .optional()
+        .describe("The new description of the label"),
+    priority: z
+        .number()
+        .nullable()
+        .optional()
+        .describe("The new priority of the label"),
 });
 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
+        .union([z.number(), z.string()])
+        .describe("The ID or title of a project's label"),
 });
 // Group projects schema
 export const ListGroupProjectsSchema = z.object({
     group_id: z.string().describe("Group ID or path"),
-    include_subgroups: z.boolean().optional().describe("Include projects from subgroups"),
+    include_subgroups: z
+        .boolean()
+        .optional()
+        .describe("Include projects from subgroups"),
     search: z.string().optional().describe("Search term to filter projects"),
-    order_by: z.enum(['name', 'path', 'created_at', 'updated_at', 'last_activity_at']).optional().describe("Field to sort by"),
-    sort: z.enum(['asc', 'desc']).optional().describe("Sort direction"),
+    order_by: z
+        .enum(["name", "path", "created_at", "updated_at", "last_activity_at"])
+        .optional()
+        .describe("Field to sort by"),
+    sort: z.enum(["asc", "desc"]).optional().describe("Sort direction"),
     page: z.number().optional().describe("Page number"),
     per_page: z.number().optional().describe("Number of results per page"),
     archived: z.boolean().optional().describe("Filter for archived projects"),
-    visibility: z.enum(["public", "internal", "private"]).optional().describe("Filter by project visibility"),
-    with_issues_enabled: z.boolean().optional().describe("Filter projects with issues feature enabled"),
-    with_merge_requests_enabled: z.boolean().optional().describe("Filter projects with merge requests feature enabled"),
-    min_access_level: z.number().optional().describe("Filter by minimum access level"),
-    with_programming_language: z.string().optional().describe("Filter by programming language"),
+    visibility: z
+        .enum(["public", "internal", "private"])
+        .optional()
+        .describe("Filter by project visibility"),
+    with_issues_enabled: z
+        .boolean()
+        .optional()
+        .describe("Filter projects with issues feature enabled"),
+    with_merge_requests_enabled: z
+        .boolean()
+        .optional()
+        .describe("Filter projects with merge requests feature enabled"),
+    min_access_level: z
+        .number()
+        .optional()
+        .describe("Filter by minimum access level"),
+    with_programming_language: z
+        .string()
+        .optional()
+        .describe("Filter by programming language"),
     starred: z.boolean().optional().describe("Filter by starred projects"),
     statistics: z.boolean().optional().describe("Include project statistics"),
-    with_custom_attributes: z.boolean().optional().describe("Include custom attributes"),
-    with_security_reports: z.boolean().optional().describe("Include security reports")
+    with_custom_attributes: z
+        .boolean()
+        .optional()
+        .describe("Include custom attributes"),
+    with_security_reports: z
+        .boolean()
+        .optional()
+        .describe("Include security reports"),
 });
 // Add wiki operation schemas
 export const ListWikiPagesSchema = z.object({
@@ -696,14 +885,20 @@ export const CreateWikiPageSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
     title: z.string().describe("Title of the wiki page"),
     content: z.string().describe("Content of the wiki page"),
-    format: z.string().optional().describe("Content format, e.g., markdown, rdoc"),
+    format: z
+        .string()
+        .optional()
+        .describe("Content format, e.g., markdown, rdoc"),
 });
 export const UpdateWikiPageSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
     slug: z.string().describe("URL-encoded slug of the wiki page"),
     title: z.string().optional().describe("New title of the wiki page"),
     content: z.string().optional().describe("New content of the wiki page"),
-    format: z.string().optional().describe("Content format, e.g., markdown, rdoc"),
+    format: z
+        .string()
+        .optional()
+        .describe("Content format, e.g., markdown, rdoc"),
 });
 export const DeleteWikiPageSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),

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

@@ -0,0 +1,41 @@
+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);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "1.0.32",
+  "version": "1.0.34",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",
@@ -19,7 +19,8 @@
     "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
     "prepare": "npm run build",
     "watch": "tsc --watch",
-    "deploy": "npm publish --access public"
+    "deploy": "npm publish --access public",
+    "generate-tools": "npx ts-node scripts/generate-tools-readme.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.8.0",