@zereight/mcp-gitlab 1.0.74 → 1.0.76

package/build/customSchemas.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { pino } from 'pino';
+const DEFAULT_NULL = process.env.DEFAULT_NULL === "true";
 const logger = pino({
     level: process.env.LOG_LEVEL || 'info',
     transport: {
@@ -17,3 +18,4 @@ export const flexibleBoolean = z.preprocess((val) => {
     }
     return val;
 }, z.boolean());
+export const flexibleBooleanNullable = DEFAULT_NULL ? flexibleBoolean.nullable().default(null) : flexibleBoolean.nullable();

package/build/index.js

@@ -28,7 +28,7 @@ GetPipelineJobOutputSchema, GitLabPipelineJobSchema,
 GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, PaginatedDiscussionsResponseSchema, UpdateMergeRequestNoteSchema, // Added
 CreateMergeRequestNoteSchema, // Added
-ListMergeRequestDiscussionsSchema, UpdateIssueNoteSchema, CreateIssueNoteSchema, ListMergeRequestsSchema, GitLabMilestonesSchema, ListProjectMilestonesSchema, GetProjectMilestoneSchema, CreateProjectMilestoneSchema, EditProjectMilestoneSchema, DeleteProjectMilestoneSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, PromoteProjectMilestoneSchema, GetMilestoneBurndownEventsSchema, GitLabCompareResultSchema, GetBranchDiffsSchema, ListCommitsSchema, GetCommitSchema, GetCommitDiffSchema, ListMergeRequestDiffsSchema, } from "./schemas.js";
+ListMergeRequestDiscussionsSchema, UpdateIssueNoteSchema, CreateIssueNoteSchema, ListMergeRequestsSchema, GitLabMilestonesSchema, ListProjectMilestonesSchema, GetProjectMilestoneSchema, CreateProjectMilestoneSchema, EditProjectMilestoneSchema, DeleteProjectMilestoneSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, PromoteProjectMilestoneSchema, GetMilestoneBurndownEventsSchema, GitLabCompareResultSchema, GetBranchDiffsSchema, ListCommitsSchema, GetCommitSchema, GetCommitDiffSchema, ListMergeRequestDiffsSchema, ListGroupIterationsSchema, GroupIteration, } from "./schemas.js";
 import { randomUUID } from "crypto";
 import { pino } from 'pino';
 const logger = pino({
@@ -320,7 +320,7 @@ const allTools = [
     },
     {
         name: "list_issues",
-        description: "List issues in a GitLab project with filtering options",
+        description: "List issues (default: created by current user only; use scope='all' for all accessible issues)",
         inputSchema: zodToJsonSchema(ListIssuesSchema),
     },
     {
@@ -558,6 +558,11 @@ const allTools = [
         description: "Get changes/diffs of a specific commit",
         inputSchema: zodToJsonSchema(GetCommitDiffSchema),
     },
+    {
+        name: "list_group_iterations",
+        description: "List group iterations with filtering options",
+        inputSchema: zodToJsonSchema(ListGroupIterationsSchema),
+    },
 ];
 // Define which tools are read-only
 const readOnlyTools = [
@@ -598,6 +603,8 @@ const readOnlyTools = [
     "list_commits",
     "get_commit",
     "get_commit_diff",
+    "list_group_iterations",
+    "get_group_iteration",
 ];
 // Define which tools are related to wiki and can be toggled by USE_GITLAB_WIKI
 const wikiToolNames = [
@@ -823,17 +830,23 @@ async function createIssue(projectId, options) {
     return GitLabIssueSchema.parse(data);
 }
 /**
- * List issues in a GitLab project
+ * List issues across all accessible projects or within a specific project
  * 프로젝트의 이슈 목록 조회
  *
- * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {string} projectId - The ID or URL-encoded path of the project (optional)
  * @param {Object} options - Options for listing issues
  * @returns {Promise<GitLabIssue[]>} List of issues
  */
 async function listIssues(projectId, options = {}) {
-    projectId = decodeURIComponent(projectId); // Decode project ID
-    const effectiveProjectId = getEffectiveProjectId(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}/issues`);
+    let url;
+    if (projectId) {
+        projectId = decodeURIComponent(projectId); // Decode project ID
+        const effectiveProjectId = getEffectiveProjectId(projectId);
+        url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}/issues`);
+    }
+    else {
+        url = new URL(`${GITLAB_API_URL}/issues`);
+    }
     // Add all query parameters
     Object.entries(options).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -1053,6 +1066,7 @@ async function createMergeRequest(projectId, options) {
             description: options.description,
             source_branch: options.source_branch,
             target_branch: options.target_branch,
+            target_project_id: options.target_project_id,
             assignee_ids: options.assignee_ids,
             reviewer_ids: options.reviewer_ids,
             labels: options.labels?.join(","),
@@ -2573,6 +2587,42 @@ async function getCommitDiff(projectId, sha) {
     const data = await response.json();
     return z.array(GitLabDiffSchema).parse(data);
 }
+/**
+ * list group iterations
+ *
+ * @param {string} groupId
+ * @param {Omit<ListGroupIterationsOptions, "group_id">} options
+ * @returns {Promise<GetIt[]>}
+ */
+async function listGroupIterations(groupId, options = {}) {
+    groupId = decodeURIComponent(groupId);
+    const url = new URL(`${GITLAB_API_URL}/groups/${encodeURIComponent(groupId)}/iterations`);
+    // クエリパラメータの追加
+    if (options.state)
+        url.searchParams.append("state", options.state);
+    if (options.search)
+        url.searchParams.append("search", options.search);
+    if (options.in)
+        url.searchParams.append("in", options.in.join(","));
+    if (options.include_ancestors !== undefined)
+        url.searchParams.append("include_ancestors", options.include_ancestors.toString());
+    if (options.include_descendants !== undefined)
+        url.searchParams.append("include_descendants", options.include_descendants.toString());
+    if (options.updated_before)
+        url.searchParams.append("updated_before", options.updated_before);
+    if (options.updated_after)
+        url.searchParams.append("updated_after", options.updated_after);
+    if (options.page)
+        url.searchParams.append("page", options.page.toString());
+    if (options.per_page)
+        url.searchParams.append("per_page", options.per_page.toString());
+    const response = await fetch(url.toString(), DEFAULT_FETCH_CONFIG);
+    if (!response.ok) {
+        await handleGitLabError(response);
+    }
+    const data = await response.json();
+    return z.array(GroupIteration).parse(data);
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     // Apply read-only filter first
     const tools0 = GITLAB_READ_ONLY_MODE
@@ -3301,6 +3351,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(diff, null, 2) }],
                 };
             }
+            case "list_group_iterations": {
+                const args = ListGroupIterationsSchema.parse(request.params.arguments);
+                const iterations = await listGroupIterations(args.group_id, args);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(iterations, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${request.params.name}`);
         }

package/build/schemas.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { flexibleBoolean } from "./customSchemas.js";
+import { flexibleBoolean, flexibleBooleanNullable } from "./customSchemas.js";
 // Base schemas for common types
 export const GitLabAuthorSchema = z.object({
     name: z.string(),
@@ -294,7 +294,7 @@ export const GitLabRepositorySchema = z.object({
     jobs_enabled: flexibleBoolean.optional(),
     snippets_enabled: flexibleBoolean.optional(),
     can_create_merge_request_in: flexibleBoolean.optional(),
-    resolve_outdated_diff_discussions: flexibleBoolean.nullable().optional(),
+    resolve_outdated_diff_discussions: flexibleBooleanNullable.optional(),
     shared_runners_enabled: flexibleBoolean.optional(),
     shared_with_groups: z
         .array(z.object({
@@ -518,7 +518,7 @@ export const GitLabIssueSchema = z.object({
         .optional(),
     confidential: flexibleBoolean.optional(),
     due_date: z.string().nullable().optional(),
-    discussion_locked: flexibleBoolean.nullable().optional(),
+    discussion_locked: flexibleBooleanNullable.optional(),
     weight: z.number().nullable().optional(),
 });
 // NEW SCHEMA: For issue with link details (used in listing issue links)
@@ -576,8 +576,8 @@ export const GitLabMergeRequestSchema = z.object({
     merge_error: z.string().nullable().optional(),
     work_in_progress: flexibleBoolean.optional(),
     blocking_discussions_resolved: flexibleBoolean.optional(),
-    should_remove_source_branch: flexibleBoolean.nullable().optional(),
-    force_remove_source_branch: flexibleBoolean.nullable().optional(),
+    should_remove_source_branch: flexibleBooleanNullable.optional(),
+    force_remove_source_branch: flexibleBooleanNullable.optional(),
     allow_collaboration: flexibleBoolean.optional(),
     allow_maintainer_to_push: flexibleBoolean.optional(),
     changes_count: z.string().nullable().optional(),
@@ -752,6 +752,7 @@ const MergeRequestOptionsSchema = {
     description: z.string().optional().describe("Merge request description"),
     source_branch: z.string().describe("Branch containing changes"),
     target_branch: z.string().describe("Branch to merge into"),
+    target_project_id: z.coerce.string().optional().describe("Numeric ID of the target project."),
     assignee_ids: z
         .array(z.number())
         .optional()
@@ -766,8 +767,8 @@ const MergeRequestOptionsSchema = {
         .boolean()
         .optional()
         .describe("Allow commits from upstream members"),
-    remove_source_branch: flexibleBoolean.optional().nullable().describe("Flag indicating if a merge request should remove the source branch when merging."),
-    squash: flexibleBoolean.optional().nullable().describe("If true, squash all commits into a single commit on merge."),
+    remove_source_branch: flexibleBooleanNullable.optional().describe("Flag indicating if a merge request should remove the source branch when merging."),
+    squash: flexibleBooleanNullable.optional().describe("If true, squash all commits into a single commit on merge."),
 };
 export const CreateMergeRequestOptionsSchema = z.object(MergeRequestOptionsSchema);
 export const CreateMergeRequestSchema = ProjectParamsSchema.extend(MergeRequestOptionsSchema);
@@ -831,7 +832,7 @@ export const CreateNoteSchema = z.object({
 });
 // Issues API operation schemas
 export const ListIssuesSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: z.coerce.string().optional().describe("Project ID or URL-encoded path (optional - if not provided, lists issues across all accessible projects)"),
     assignee_id: z.coerce.string().optional().describe("Return issues assigned to the given user ID. user id or none or any"),
     assignee_username: z.array(z.string()).optional().describe("Return issues assigned to the given username"),
     author_id: z.coerce.string().optional().describe("Return issues created by the given user ID"),
@@ -842,6 +843,8 @@ export const ListIssuesSchema = z.object({
     due_date: z.string().optional().describe("Return issues that have the due date"),
     labels: z.array(z.string()).optional().describe("Array of label names"),
     milestone: z.string().optional().describe("Milestone title"),
+    issue_type: z.string().optional().nullable().describe("Filter to a given type of issue. One of issue, incident, test_case or task"),
+    iteration_id: z.coerce.string().optional().nullable().describe("Return issues assigned to the given iteration ID. None returns issues that do not belong to an iteration. Any returns issues that belong to an iteration. "),
     scope: z
         .enum(["created_by_me", "assigned_to_me", "all"])
         .optional()
@@ -1227,3 +1230,27 @@ export const GetCommitDiffSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or complete URL-encoded path to project"),
     sha: z.string().describe("The commit hash or name of a repository branch or tag"),
 });
+export const GroupIteration = z.object({
+    id: z.coerce.string(),
+    iid: z.coerce.string(),
+    sequence: z.number(),
+    group_id: z.coerce.string(),
+    title: z.string().optional().nullable(),
+    description: z.string().optional().nullable(),
+    state: z.number(),
+    created_at: z.string(),
+    updated_at: z.string(),
+    due_date: z.string().optional().nullable(),
+    start_date: z.string().optional().nullable(),
+    web_url: z.string().optional().nullable(),
+});
+export const ListGroupIterationsSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+    state: z.enum(["opened", "upcoming", "current", "closed", "all"]).optional().describe("Return opened, upcoming, current, closed, or all iterations."),
+    search: z.string().optional().describe("Return only iterations with a title matching the provided string."),
+    in: z.array(z.enum(["title", "cadence_title"])).optional().describe("Fields in which fuzzy search should be performed with the query given in the argument search. The available options are title and cadence_title. Default is [title]."),
+    include_ancestors: flexibleBoolean.optional().describe("Include iterations for group and its ancestors. Defaults to true."),
+    include_descendants: flexibleBoolean.optional().describe("Include iterations for group and its descendants. Defaults to false."),
+    updated_before: z.string().optional().describe("Return only iterations updated before the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z)."),
+    updated_after: z.string().optional().describe("Return only iterations updated after the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z)."),
+}).merge(PaginationOptionsSchema);

package/package.json

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