@zereight/mcp-gitlab 1.0.20 → 1.0.22

package/README.md

@@ -174,12 +174,96 @@ env GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token GITLAB_API_URL=your_gitlab_ap
       - `body` (string): Note content
     - Returns: Details of the created note
 
-| **`list_projects`** | List accessible projects with rich filtering options 📊 | • Search/filtering: `search`, `owned`, `membership`, `archived`, `visibility`<br>• Features filtering: `with_issues_enabled`, `with_merge_requests_enabled`<br>• Sorting: `order_by`, `sort`<br>• Access control: `min_access_level`<br>• Pagination: `page`, `per_page`, `simple` | Array of projects |
-| **`list_labels`** | List all labels for a project with filtering options 🏷️ | • `project_id` (string): Project ID or path<br>• `with_counts` (optional): Include issue and merge request counts<br>• `include_ancestor_groups` (optional): Include ancestor groups<br>• `search` (optional): Filter labels by keyword | Array of labels |
-| **`get_label`** | Get a single label from a project 🏷️ | • `project_id` (string): Project ID or path<br>• `label_id` (number/string): Label ID or name<br>• `include_ancestor_groups` (optional): Include ancestor groups | Label details |
-| **`create_label`** | Create a new label in a project 🏷️➕ | • `project_id` (string): Project ID or path<br>• `name` (string): Label name<br>• `color` (string): Color in hex format (e.g., "#FF0000")<br>• `description` (optional): Label description<br>• `priority` (optional): Label priority | Created label details |
-| **`update_label`** | Update an existing label in a project 🏷️✏️ | • `project_id` (string): Project ID or path<br>• `label_id` (number/string): Label ID or name<br>• `new_name` (optional): New label name<br>• `color` (optional): New color in hex format<br>• `description` (optional): New description<br>• `priority` (optional): New priority | Updated label details |
-| **`delete_label`** | Delete a label from a project 🏷️❌ | • `project_id` (string): Project ID or path<br>• `label_id` (number/string): Label ID or name | Success message |
+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
 

package/build/index.js

@@ -9,7 +9,7 @@ import { fileURLToPath } from "url";
 import { dirname } from "path";
 import fs from "fs";
 import path from "path";
-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, } from "./schemas.js";
+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, } from "./schemas.js";
 /**
  * Read version from package.json
  */
@@ -960,6 +960,55 @@ async function deleteLabel(projectId, labelId) {
     // Handle errors
     await handleGitLabError(response);
 }
+/**
+ * List all projects in a GitLab group
+ *
+ * @param {z.infer<typeof ListGroupProjectsSchema>} options - Options for listing group projects
+ * @returns {Promise<GitLabProject[]>} Array of projects in the group
+ */
+async function listGroupProjects(options) {
+    const url = new URL(`${GITLAB_API_URL}/groups/${encodeURIComponent(options.group_id)}/projects`);
+    // Add optional parameters to URL
+    if (options.include_subgroups)
+        url.searchParams.append('include_subgroups', 'true');
+    if (options.search)
+        url.searchParams.append('search', options.search);
+    if (options.order_by)
+        url.searchParams.append('order_by', options.order_by);
+    if (options.sort)
+        url.searchParams.append('sort', options.sort);
+    if (options.page)
+        url.searchParams.append('page', options.page.toString());
+    if (options.per_page)
+        url.searchParams.append('per_page', options.per_page.toString());
+    if (options.archived !== undefined)
+        url.searchParams.append('archived', options.archived.toString());
+    if (options.visibility)
+        url.searchParams.append('visibility', options.visibility);
+    if (options.with_issues_enabled !== undefined)
+        url.searchParams.append('with_issues_enabled', options.with_issues_enabled.toString());
+    if (options.with_merge_requests_enabled !== undefined)
+        url.searchParams.append('with_merge_requests_enabled', options.with_merge_requests_enabled.toString());
+    if (options.min_access_level !== undefined)
+        url.searchParams.append('min_access_level', options.min_access_level.toString());
+    if (options.with_programming_language)
+        url.searchParams.append('with_programming_language', options.with_programming_language);
+    if (options.starred !== undefined)
+        url.searchParams.append('starred', options.starred.toString());
+    if (options.statistics !== undefined)
+        url.searchParams.append('statistics', options.statistics.toString());
+    if (options.with_custom_attributes !== undefined)
+        url.searchParams.append('with_custom_attributes', options.with_custom_attributes.toString());
+    if (options.with_security_reports !== undefined)
+        url.searchParams.append('with_security_reports', options.with_security_reports.toString());
+    const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const projects = await response.json();
+    return GitLabProjectSchema.array().parse(projects);
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
         tools: [
@@ -1118,6 +1167,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 description: "Delete a label from a project",
                 inputSchema: zodToJsonSchema(DeleteLabelSchema),
             },
+            {
+                name: "list_group_projects",
+                description: "List projects in a GitLab group with filtering options",
+                inputSchema: zodToJsonSchema(ListGroupProjectsSchema),
+            },
         ],
     };
 });
@@ -1414,6 +1468,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify({ status: "success", message: "Label deleted successfully" }, null, 2) }],
                 };
             }
+            case "list_group_projects": {
+                const args = ListGroupProjectsSchema.parse(request.params.arguments);
+                const projects = await listGroupProjects(args);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(projects, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${request.params.name}`);
         }

package/build/schemas.js

@@ -303,7 +303,7 @@ export const GitLabMergeRequestSchema = z.object({
     assignees: z.array(GitLabUserSchema).optional(),
     source_branch: z.string(),
     target_branch: z.string(),
-    diff_refs: GitLabMergeRequestDiffRefSchema.optional(),
+    diff_refs: GitLabMergeRequestDiffRefSchema.nullable().optional(),
     web_url: z.string(),
     created_at: z.string(),
     updated_at: z.string(),
@@ -316,10 +316,10 @@ export const GitLabMergeRequestSchema = z.object({
     work_in_progress: z.boolean().optional(),
     blocking_discussions_resolved: z.boolean().optional(),
     should_remove_source_branch: z.boolean().nullable().optional(),
-    force_remove_source_branch: z.boolean().optional(),
+    force_remove_source_branch: z.boolean().nullable().optional(),
     allow_collaboration: z.boolean().optional(),
     allow_maintainer_to_push: z.boolean().optional(),
-    changes_count: z.string().optional(),
+    changes_count: z.string().nullable().optional(),
     merge_when_pipeline_succeeds: z.boolean().optional(),
     squash: z.boolean().optional(),
     labels: z.array(z.string()).optional(),
@@ -597,3 +597,23 @@ 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"),
 });
+// 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"),
+    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"),
+    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"),
+    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")
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "1.0.20",
+  "version": "1.0.22",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",
@@ -22,7 +22,7 @@
     "deploy": "npm run build && npm publish"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.0.1",
+    "@modelcontextprotocol/sdk": "1.8.0",
     "@types/node-fetch": "^2.6.12",
     "node-fetch": "^3.3.2",
     "zod-to-json-schema": "^3.23.5"
@@ -30,6 +30,6 @@
   "devDependencies": {
     "@types/node": "^22.13.10",
     "typescript": "^5.8.2",
-    "zod": "3.21.4"
+    "zod": "^3.24.2"
   }
-}
+}