@zereight/mcp-gitlab 1.0.21 → 1.0.23

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,11 @@ 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, 
+// Discussion Schemas
+GitLabDiscussionNoteSchema, // Added
+GitLabDiscussionSchema, UpdateMergeRequestNoteSchema, // Added
+ListMergeRequestDiscussionsSchema, } from "./schemas.js";
 /**
  * Read version from package.json
  */
@@ -417,6 +421,51 @@ async function createMergeRequest(projectId, options) {
     const data = await response.json();
     return GitLabMergeRequestSchema.parse(data);
 }
+/**
+ * List merge request discussion items
+ * 병합 요청 토론 목록 조회
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} mergeRequestIid - The IID of a merge request
+ * @returns {Promise<GitLabDiscussion[]>} List of discussions
+ */
+async function listMergeRequestDiscussions(projectId, mergeRequestIid) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/discussions`);
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    // Ensure the response is parsed as an array of discussions
+    return z.array(GitLabDiscussionSchema).parse(data);
+}
+/**
+ * Modify an existing merge request thread note
+ * 병합 요청 토론 노트 수정
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} mergeRequestIid - The IID of a merge request
+ * @param {string} discussionId - The ID of a thread
+ * @param {number} noteId - The ID of a thread note
+ * @param {string} body - The new content of the note
+ * @param {boolean} [resolved] - Resolve/unresolve state
+ * @returns {Promise<GitLabDiscussionNote>} The updated note
+ */
+async function updateMergeRequestNote(projectId, mergeRequestIid, discussionId, noteId, body, resolved) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/discussions/${discussionId}/notes/${noteId}`);
+    const payload = { body };
+    if (resolved !== undefined) {
+        payload.resolved = resolved;
+    }
+    const response = await fetch(url.toString(), {
+        method: "PUT",
+        headers: DEFAULT_HEADERS,
+        body: JSON.stringify(payload),
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabDiscussionNoteSchema.parse(data);
+}
 /**
  * Create or update a file in a GitLab project
  * 파일 생성 또는 업데이트
@@ -960,6 +1009,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: [
@@ -1028,6 +1126,16 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 description: "Create a new note (comment) to an issue or merge request",
                 inputSchema: zodToJsonSchema(CreateNoteSchema),
             },
+            {
+                name: "list_merge_request_discussions",
+                description: "List discussion items for a merge request",
+                inputSchema: zodToJsonSchema(ListMergeRequestDiscussionsSchema),
+            },
+            {
+                name: "update_merge_request_note",
+                description: "Modify an existing merge request thread note",
+                inputSchema: zodToJsonSchema(UpdateMergeRequestNoteSchema),
+            },
             {
                 name: "list_issues",
                 description: "List issues in a GitLab project with filtering options",
@@ -1118,6 +1226,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),
+            },
         ],
     };
 });
@@ -1215,6 +1328,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "update_merge_request_note": {
+                const args = UpdateMergeRequestNoteSchema.parse(request.params.arguments);
+                const note = await updateMergeRequestNote(args.project_id, args.merge_request_iid, args.discussion_id, args.note_id, args.body, args.resolved // Pass resolved if provided
+                );
+                return {
+                    content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
+                };
+            }
             case "get_merge_request": {
                 const args = GetMergeRequestSchema.parse(request.params.arguments);
                 const mergeRequest = await getMergeRequest(args.project_id, args.merge_request_iid);
@@ -1241,6 +1362,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "list_merge_request_discussions": {
+                const args = ListMergeRequestDiscussionsSchema.parse(request.params.arguments);
+                const discussions = await listMergeRequestDiscussions(args.project_id, args.merge_request_iid);
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(discussions, null, 2) },
+                    ],
+                };
+            }
             case "list_namespaces": {
                 const args = ListNamespacesSchema.parse(request.params.arguments);
                 const url = new URL(`${GITLAB_API_URL}/namespaces`);
@@ -1414,6 +1544,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

@@ -6,6 +6,10 @@ export const GitLabAuthorSchema = z.object({
     date: z.string(),
 });
 // Namespace related schemas
+// Base schema for project-related operations
+const ProjectParamsSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"), // Changed from owner/repo to match GitLab API
+});
 export const GitLabNamespaceSchema = z.object({
     id: z.number(),
     name: z.string(),
@@ -324,10 +328,71 @@ export const GitLabMergeRequestSchema = z.object({
     squash: z.boolean().optional(),
     labels: z.array(z.string()).optional(),
 });
-// API Operation Parameter Schemas
-const ProjectParamsSchema = z.object({
-    project_id: z.string().describe("Project ID or URL-encoded path"), // Changed from owner/repo to match GitLab API
+// Discussion related schemas
+export const GitLabDiscussionNoteSchema = z.object({
+    id: z.number(),
+    type: z.enum(["DiscussionNote", "DiffNote", "Note"]).nullable(), // Allow null type for regular notes
+    body: z.string(),
+    attachment: z.any().nullable(), // Can be string or object, handle appropriately
+    author: GitLabUserSchema,
+    created_at: z.string(),
+    updated_at: z.string(),
+    system: z.boolean(),
+    noteable_id: z.number(),
+    noteable_type: z.enum(["Issue", "MergeRequest", "Snippet", "Commit", "Epic"]),
+    project_id: z.number().optional(), // Optional for group-level discussions like Epics
+    noteable_iid: z.number().nullable(),
+    resolvable: z.boolean().optional(),
+    resolved: z.boolean().optional(),
+    resolved_by: GitLabUserSchema.nullable().optional(),
+    resolved_at: z.string().nullable().optional(),
+    position: z.object({
+        base_sha: z.string(),
+        start_sha: z.string(),
+        head_sha: z.string(),
+        old_path: z.string(),
+        new_path: z.string(),
+        position_type: z.enum(["text", "image", "file"]),
+        old_line: z.number().nullable(),
+        new_line: z.number().nullable(),
+        line_range: z.object({
+            start: z.object({
+                line_code: z.string(),
+                type: z.enum(["new", "old"]),
+                old_line: z.number().nullable(),
+                new_line: z.number().nullable(),
+            }),
+            end: z.object({
+                line_code: z.string(),
+                type: z.enum(["new", "old"]),
+                old_line: z.number().nullable(),
+                new_line: z.number().nullable(),
+            }),
+        }).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(),
 });
+export const GitLabDiscussionSchema = z.object({
+    id: z.string(),
+    individual_note: z.boolean(),
+    notes: z.array(GitLabDiscussionNoteSchema),
+});
+// Input schema for listing merge request discussions
+export const ListMergeRequestDiscussionsSchema = ProjectParamsSchema.extend({
+    merge_request_iid: z.number().describe("The IID of a merge request"),
+});
+// Input schema for updating a merge request discussion note
+export const UpdateMergeRequestNoteSchema = ProjectParamsSchema.extend({
+    merge_request_iid: z.number().describe("The IID of a merge request"),
+    discussion_id: z.string().describe("The ID of a thread"),
+    note_id: z.number().describe("The ID of a thread note"),
+    body: z.string().describe("The content of the note or reply"),
+    resolved: z.boolean().optional().describe("Resolve or unresolve the note"), // Optional based on API docs
+});
+// API Operation Parameter Schemas
 export const CreateOrUpdateFileSchema = ProjectParamsSchema.extend({
     file_path: z.string().describe("Path where to create/update the file"),
     content: z.string().describe("Content of the file"),
@@ -597,3 +662,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.21",
+  "version": "1.0.23",
   "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"
   }
-}
+}