@zereight/mcp-gitlab 1.0.50 → 1.0.51

package/README.md

@@ -26,7 +26,8 @@ When using with the Claude App, you need to set up your API key and URLs directl
         "GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token",
         "GITLAB_API_URL": "your_gitlab_api_url",
         "GITLAB_READ_ONLY_MODE": "false",
-        "USE_GITLAB_WIKI": "true"
+        "USE_GITLAB_WIKI": "false",
+        "USE_MILESTONE": "false"
       }
     }
   }
@@ -52,13 +53,16 @@ When using with the Claude App, you need to set up your API key and URLs directl
         "GITLAB_READ_ONLY_MODE",
         "-e",
         "USE_GITLAB_WIKI",
+        "-e",
+        "USE_MILESTONE",
         "iwakitakuma/gitlab-mcp"
       ],
       "env": {
         "GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token",
         "GITLAB_API_URL": "https://gitlab.com/api/v4", // Optional, for self-hosted GitLab
         "GITLAB_READ_ONLY_MODE": "false",
-        "USE_GITLAB_WIKI": "true"
+        "USE_GITLAB_WIKI": "true",
+        "USE_MILESTONE": "true"
       }
     }
   }
@@ -77,10 +81,12 @@ $ sh scripts/image_push.sh docker_user_name
 - `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.
+- `USE_MILESTONE`: When set to 'true', enables the milestone-related tools (list_milestones, get_milestone, create_milestone, edit_milestone, delete_milestone, get_milestone_issue, get_milestone_merge_requests, promote_milestone, get_milestone_burndown_events). By default, milestone features are disabled.
 
 ## Tools 🛠️
 
 +<!-- 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

package/build/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 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 { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import fetch from "node-fetch";
 import { SocksProxyAgent } from "socks-proxy-agent";
 import { HttpsProxyAgent } from "https-proxy-agent";
@@ -48,6 +48,7 @@ const server = new Server({
 const GITLAB_PERSONAL_ACCESS_TOKEN = process.env.GITLAB_PERSONAL_ACCESS_TOKEN;
 const GITLAB_READ_ONLY_MODE = process.env.GITLAB_READ_ONLY_MODE === "true";
 const USE_GITLAB_WIKI = process.env.USE_GITLAB_WIKI === "true";
+const USE_MILESTONE = process.env.USE_MILESTONE === "true";
 // Add proxy configuration
 const HTTP_PROXY = process.env.HTTP_PROXY;
 const HTTPS_PROXY = process.env.HTTPS_PROXY;
@@ -421,6 +422,8 @@ const readOnlyTools = [
     "get_milestone_issue",
     "get_milestone_merge_requests",
     "get_milestone_burndown_events",
+    "list_wiki_pages",
+    "get_wiki_page",
 ];
 // Define which tools are related to wiki and can be toggled by USE_GITLAB_WIKI
 const wikiToolNames = [
@@ -431,6 +434,18 @@ const wikiToolNames = [
     "delete_wiki_page",
     "upload_wiki_attachment",
 ];
+// Define which tools are related to milestones and can be toggled by USE_MILESTONE
+const milestoneToolNames = [
+    "list_milestones",
+    "get_milestone",
+    "create_milestone",
+    "edit_milestone",
+    "delete_milestone",
+    "get_milestone_issue",
+    "get_milestone_merge_requests",
+    "promote_milestone",
+    "get_milestone_burndown_events",
+];
 /**
  * Smart URL handling for GitLab API
  *
@@ -444,8 +459,7 @@ function normalizeGitLabApiUrl(url) {
     // Remove trailing slash if present
     let normalizedUrl = url.endsWith("/") ? url.slice(0, -1) : url;
     // Check if URL already has /api/v4
-    if (!normalizedUrl.endsWith("/api/v4") &&
-        !normalizedUrl.endsWith("/api/v4/")) {
+    if (!normalizedUrl.endsWith("/api/v4") && !normalizedUrl.endsWith("/api/v4/")) {
         // Append /api/v4 if not already present
         normalizedUrl = `${normalizedUrl}/api/v4`;
     }
@@ -468,8 +482,7 @@ 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}`);
@@ -1095,7 +1108,7 @@ async function createTree(projectId, files, ref) {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
         body: JSON.stringify({
-            files: files.map((file) => ({
+            files: files.map(file => ({
                 file_path: file.path,
                 content: file.content,
                 encoding: "text",
@@ -1132,7 +1145,7 @@ async function createCommit(projectId, message, branch, actions) {
         body: JSON.stringify({
             branch,
             commit_message: message,
-            actions: actions.map((action) => ({
+            actions: actions.map(action => ({
                 action: "create",
                 file_path: action.path,
                 content: action.content,
@@ -1892,7 +1905,7 @@ async function listProjectMilestones(projectId, options) {
     Object.entries(options).forEach(([key, value]) => {
         if (value !== undefined) {
             if (key === "iids" && Array.isArray(value) && value.length > 0) {
-                value.forEach((iid) => {
+                value.forEach(iid => {
                     url.searchParams.append("iids[]", iid.toString());
                 });
             }
@@ -2044,18 +2057,20 @@ async function getMilestoneBurndownEvents(projectId, milestoneId) {
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     // Apply read-only filter first
     const tools0 = GITLAB_READ_ONLY_MODE
-        ? allTools.filter((tool) => readOnlyTools.includes(tool.name))
+        ? allTools.filter(tool => readOnlyTools.includes(tool.name))
         : allTools;
     // Toggle wiki tools by USE_GITLAB_WIKI flag
-    let tools = USE_GITLAB_WIKI
+    const tools1 = USE_GITLAB_WIKI
         ? tools0
-        : tools0.filter((tool) => !wikiToolNames.includes(tool.name));
+        : tools0.filter(tool => !wikiToolNames.includes(tool.name));
+    // Toggle milestone tools by USE_MILESTONE flag
+    let tools = USE_MILESTONE
+        ? tools1
+        : tools1.filter(tool => !milestoneToolNames.includes(tool.name));
     // <<< START: Gemini 호환성을 위해 $schema 제거 >>>
-    tools = tools.map((tool) => {
+    tools = tools.map(tool => {
         // inputSchema가 존재하고 객체인지 확인
-        if (tool.inputSchema &&
-            typeof tool.inputSchema === "object" &&
-            tool.inputSchema !== null) {
+        if (tool.inputSchema && typeof tool.inputSchema === "object" && tool.inputSchema !== null) {
             // $schema 키가 존재하면 삭제
             if ("$schema" in tool.inputSchema) {
                 // 불변성을 위해 새로운 객체 생성 (선택적이지만 권장)
@@ -2083,9 +2098,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 try {
                     const forkedProject = await forkProject(forkArgs.project_id, forkArgs.namespace);
                     return {
-                        content: [
-                            { type: "text", text: JSON.stringify(forkedProject, null, 2) },
-                        ],
+                        content: [{ type: "text", text: JSON.stringify(forkedProject, null, 2) }],
                     };
                 }
                 catch (forkError) {
@@ -2129,9 +2142,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const args = CreateRepositorySchema.parse(request.params.arguments);
                 const repository = await createRepository(args);
                 return {
-                    content: [
-                        { type: "text", text: JSON.stringify(repository, null, 2) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(repository, null, 2) }],
                 };
             }
             case "get_file_contents": {
@@ -2150,7 +2161,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "push_files": {
                 const args = PushFilesSchema.parse(request.params.arguments);
-                const result = await createCommit(args.project_id, args.commit_message, args.branch, args.files.map((f) => ({ path: f.file_path, content: f.content })));
+                const result = await createCommit(args.project_id, args.commit_message, args.branch, args.files.map(f => ({ path: f.file_path, content: f.content })));
                 return {
                     content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
                 };
@@ -2168,9 +2179,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const { project_id, ...options } = args;
                 const mergeRequest = await createMergeRequest(project_id, options);
                 return {
-                    content: [
-                        { type: "text", text: JSON.stringify(mergeRequest, null, 2) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(mergeRequest, null, 2) }],
                 };
             }
             case "update_merge_request_note": {
@@ -2207,9 +2216,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const args = GetMergeRequestSchema.parse(request.params.arguments);
                 const mergeRequest = await getMergeRequest(args.project_id, args.merge_request_iid, args.source_branch);
                 return {
-                    content: [
-                        { type: "text", text: JSON.stringify(mergeRequest, null, 2) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(mergeRequest, null, 2) }],
                 };
             }
             case "get_merge_request_diffs": {
@@ -2224,18 +2231,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 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) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(mergeRequest, null, 2) }],
                 };
             }
             case "mr_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) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(discussions, null, 2) }],
                 };
             }
             case "list_namespaces": {
@@ -2260,9 +2263,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const data = await response.json();
                 const namespaces = z.array(GitLabNamespaceSchema).parse(data);
                 return {
-                    content: [
-                        { type: "text", text: JSON.stringify(namespaces, null, 2) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(namespaces, null, 2) }],
                 };
             }
             case "get_namespace": {
@@ -2288,9 +2289,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const data = await response.json();
                 const namespaceExists = GitLabNamespaceExistsResponseSchema.parse(data);
                 return {
-                    content: [
-                        { type: "text", text: JSON.stringify(namespaceExists, null, 2) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(namespaceExists, null, 2) }],
                 };
             }
             case "get_project": {
@@ -2376,9 +2375,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const { project_id, issue_iid, ...options } = args;
                 const discussions = await listIssueDiscussions(project_id, issue_iid, options);
                 return {
-                    content: [
-                        { type: "text", text: JSON.stringify(discussions, null, 2) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(discussions, null, 2) }],
                 };
             }
             case "get_issue_link": {
@@ -2568,9 +2565,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const args = ListMergeRequestsSchema.parse(request.params.arguments);
                 const mergeRequests = await listMergeRequests(args.project_id, args);
                 return {
-                    content: [
-                        { type: "text", text: JSON.stringify(mergeRequests, null, 2) },
-                    ],
+                    content: [{ type: "text", text: JSON.stringify(mergeRequests, null, 2) }],
                 };
             }
             case "list_milestones": {
@@ -2691,7 +2686,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     catch (error) {
         if (error instanceof z.ZodError) {
             throw new Error(`Invalid arguments: ${error.errors
-                .map((e) => `${e.path.join(".")}: ${e.message}`)
+                .map(e => `${e.path.join(".")}: ${e.message}`)
                 .join(", ")}`);
         }
         throw error;
@@ -2716,7 +2711,7 @@ async function runServer() {
         process.exit(1);
     }
 }
-runServer().catch((error) => {
+runServer().catch(error => {
     console.error("Fatal error in main():", error);
     process.exit(1);
 });

package/build/schemas.js

@@ -20,13 +20,16 @@ export const GitLabPipelineSchema = z.object({
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
     coverage: z.number().nullable().optional(),
-    user: z.object({
+    user: z
+        .object({
         id: z.number(),
         name: z.string(),
         username: z.string(),
         avatar_url: z.string().nullable().optional(),
-    }).optional(),
-    detailed_status: z.object({
+    })
+        .optional(),
+    detailed_status: z
+        .object({
         icon: z.string().optional(),
         text: z.string().optional(),
         label: z.string().optional(),
@@ -34,13 +37,17 @@ export const GitLabPipelineSchema = z.object({
         tooltip: z.string().optional(),
         has_details: z.boolean().optional(),
         details_path: z.string().optional(),
-        illustration: z.object({
+        illustration: z
+            .object({
             image: z.string().optional(),
             size: z.string().optional(),
             title: z.string().optional(),
-        }).nullable().optional(),
+        })
+            .nullable()
+            .optional(),
         favicon: z.string().optional(),
-    }).optional(),
+    })
+        .optional(),
 });
 // Pipeline job related schemas
 export const GitLabPipelineJobSchema = z.object({
@@ -55,41 +62,74 @@ export const GitLabPipelineJobSchema = z.object({
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
     duration: z.number().nullable().optional(),
-    user: z.object({
+    user: z
+        .object({
         id: z.number(),
         name: z.string(),
         username: z.string(),
         avatar_url: z.string().nullable().optional(),
-    }).optional(),
-    commit: z.object({
+    })
+        .optional(),
+    commit: z
+        .object({
         id: z.string(),
         short_id: z.string(),
         title: z.string(),
         author_name: z.string(),
         author_email: z.string(),
-    }).optional(),
-    pipeline: z.object({
+    })
+        .optional(),
+    pipeline: z
+        .object({
         id: z.number(),
         project_id: z.number(),
         status: z.string(),
         ref: z.string(),
         sha: z.string(),
-    }).optional(),
+    })
+        .optional(),
     web_url: z.string().optional(),
 });
 // Schema for listing pipelines
 export const ListPipelinesSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    scope: z.enum(['running', 'pending', 'finished', 'branches', 'tags']).optional().describe("The scope of pipelines"),
-    status: z.enum(['created', 'waiting_for_resource', 'preparing', 'pending', 'running', 'success', 'failed', 'canceled', 'skipped', 'manual', 'scheduled']).optional().describe("The status of pipelines"),
+    scope: z
+        .enum(["running", "pending", "finished", "branches", "tags"])
+        .optional()
+        .describe("The scope of pipelines"),
+    status: z
+        .enum([
+        "created",
+        "waiting_for_resource",
+        "preparing",
+        "pending",
+        "running",
+        "success",
+        "failed",
+        "canceled",
+        "skipped",
+        "manual",
+        "scheduled",
+    ])
+        .optional()
+        .describe("The status of pipelines"),
     ref: z.string().optional().describe("The ref of pipelines"),
     sha: z.string().optional().describe("The SHA of pipelines"),
     yaml_errors: z.boolean().optional().describe("Returns pipelines with invalid configurations"),
     username: z.string().optional().describe("The username of the user who triggered pipelines"),
-    updated_after: z.string().optional().describe("Return pipelines updated after the specified date"),
-    updated_before: z.string().optional().describe("Return pipelines updated before the specified date"),
-    order_by: z.enum(['id', 'status', 'ref', 'updated_at', 'user_id']).optional().describe("Order pipelines by"),
-    sort: z.enum(['asc', 'desc']).optional().describe("Sort pipelines"),
+    updated_after: z
+        .string()
+        .optional()
+        .describe("Return pipelines updated after the specified date"),
+    updated_before: z
+        .string()
+        .optional()
+        .describe("Return pipelines updated before the specified date"),
+    order_by: z
+        .enum(["id", "status", "ref", "updated_at", "user_id"])
+        .optional()
+        .describe("Order pipelines by"),
+    sort: z.enum(["asc", "desc"]).optional().describe("Sort pipelines"),
     page: z.number().optional().describe("Page number for pagination"),
     per_page: z.number().optional().describe("Number of items per page (max 100)"),
 });
@@ -102,7 +142,10 @@ export const GetPipelineSchema = z.object({
 export const ListPipelineJobsSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
     pipeline_id: z.number().describe("The ID of the pipeline"),
-    scope: z.enum(['created', 'pending', 'running', 'failed', 'success', 'canceled', 'skipped', 'manual']).optional().describe("The scope of jobs to show"),
+    scope: z
+        .enum(["created", "pending", "running", "failed", "success", "canceled", "skipped", "manual"])
+        .optional()
+        .describe("The scope of jobs to show"),
     include_retried: z.boolean().optional().describe("Whether to include retried jobs"),
     page: z.number().optional().describe("Page number for pagination"),
     per_page: z.number().optional().describe("Number of items per page (max 100)"),
@@ -267,18 +310,9 @@ export const GetRepositoryTreeSchema = z.object({
         .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"),
+    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({
@@ -319,7 +353,7 @@ export const GitLabMilestonesSchema = z.object({
     updated_at: z.string(),
     created_at: z.string(),
     expired: z.boolean(),
-    web_url: z.string().optional()
+    web_url: z.string().optional(),
 });
 // Input schemas for operations
 export const CreateRepositoryOptionsSchema = z.object({
@@ -558,10 +592,12 @@ export const UpdateMergeRequestNoteSchema = ProjectParamsSchema.extend({
     note_id: z.number().describe("The ID of a thread note"),
     body: z.string().optional().describe("The content of the note or reply"),
     resolved: z.boolean().optional().describe("Resolve or unresolve the note"),
-}).refine(data => data.body !== undefined || data.resolved !== undefined, {
-    message: "At least one of 'body' or 'resolved' must be provided"
-}).refine(data => !(data.body !== undefined && data.resolved !== undefined), {
-    message: "Only one of 'body' or 'resolved' can be provided, not both"
+})
+    .refine(data => data.body !== undefined || data.resolved !== undefined, {
+    message: "At least one of 'body' or 'resolved' must be provided",
+})
+    .refine(data => !(data.body !== undefined && data.resolved !== undefined), {
+    message: "Only one of 'body' or 'resolved' can be provided, not both",
 });
 // Input schema for adding a note to an existing merge request discussion
 export const CreateMergeRequestNoteSchema = ProjectParamsSchema.extend({
@@ -590,26 +626,14 @@ export const CreateOrUpdateFileSchema = ProjectParamsSchema.extend({
     content: z.string().describe("Content of the file"),
     commit_message: z.string().describe("Commit message"),
     branch: z.string().describe("Branch to create/update the file in"),
-    previous_path: z
-        .string()
-        .optional()
-        .describe("Path of the file to move/rename"),
+    previous_path: z.string().optional().describe("Path of the file to move/rename"),
     last_commit_id: z.string().optional().describe("Last known file commit ID"),
-    commit_id: z
-        .string()
-        .optional()
-        .describe("Current file commit ID (for update operations)"),
+    commit_id: z.string().optional().describe("Current file commit ID (for update operations)"),
 });
 export const SearchRepositoriesSchema = z.object({
     search: z.string().describe("Search query"), // Changed from query to match GitLab API
-    page: z
-        .number()
-        .optional()
-        .describe("Page number for pagination (default: 1)"),
-    per_page: z
-        .number()
-        .optional()
-        .describe("Number of results per page (default: 20)"),
+    page: z.number().optional().describe("Page number for pagination (default: 1)"),
+    per_page: z.number().optional().describe("Number of results per page (default: 20)"),
 });
 export const CreateRepositorySchema = z.object({
     name: z.string().describe("Repository name"),
@@ -618,10 +642,7 @@ export const CreateRepositorySchema = z.object({
         .enum(["private", "internal", "public"])
         .optional()
         .describe("Repository visibility level"),
-    initialize_with_readme: z
-        .boolean()
-        .optional()
-        .describe("Initialize with README.md"),
+    initialize_with_readme: z.boolean().optional().describe("Initialize with README.md"),
 });
 export const GetFileContentsSchema = ProjectParamsSchema.extend({
     file_path: z.string().describe("Path to the file or directory"),
@@ -640,10 +661,7 @@ export const PushFilesSchema = ProjectParamsSchema.extend({
 export const CreateIssueSchema = ProjectParamsSchema.extend({
     title: z.string().describe("Issue title"),
     description: z.string().optional().describe("Issue description"),
-    assignee_ids: z
-        .array(z.number())
-        .optional()
-        .describe("Array of user IDs to assign"),
+    assignee_ids: z.array(z.number()).optional().describe("Array of user IDs to assign"),
     labels: z.array(z.string()).optional().describe("Array of label names"),
     milestone_id: z.number().optional().describe("Milestone ID to assign"),
 });
@@ -653,10 +671,7 @@ export const CreateMergeRequestSchema = ProjectParamsSchema.extend({
     source_branch: z.string().describe("Branch containing changes"),
     target_branch: z.string().describe("Branch to merge into"),
     draft: z.boolean().optional().describe("Create as draft merge request"),
-    allow_collaboration: z
-        .boolean()
-        .optional()
-        .describe("Allow commits from upstream members"),
+    allow_collaboration: z.boolean().optional().describe("Allow commits from upstream members"),
 });
 export const ForkRepositorySchema = ProjectParamsSchema.extend({
     namespace: z.string().optional().describe("Namespace to fork to (full path)"),
@@ -676,23 +691,14 @@ export const GitLabMergeRequestDiffSchema = z.object({
     deleted_file: z.boolean(),
 });
 export const GetMergeRequestSchema = ProjectParamsSchema.extend({
-    merge_request_iid: z
-        .number()
-        .optional()
-        .describe("The IID of a merge request"),
+    merge_request_iid: z.number().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"),
-    description: z
-        .string()
-        .optional()
-        .describe("The description of the merge request"),
+    description: z.string().optional().describe("The description of the merge request"),
     target_branch: z.string().optional().describe("The target branch"),
-    assignee_ids: z
-        .array(z.number())
-        .optional()
-        .describe("The ID of the users to assign the MR to"),
+    assignee_ids: z.array(z.number()).optional().describe("The ID of the users to assign the MR to"),
     labels: z.array(z.string()).optional().describe("Labels for the MR"),
     state_event: z
         .enum(["close", "reopen"])
@@ -702,10 +708,7 @@ export const UpdateMergeRequestSchema = GetMergeRequestSchema.extend({
         .boolean()
         .optional()
         .describe("Flag indicating if the source branch should be removed"),
-    squash: z
-        .boolean()
-        .optional()
-        .describe("Squash commits into a single commit when merging"),
+    squash: z.boolean().optional().describe("Squash commits into a single commit when merging"),
     draft: z.boolean().optional().describe("Work in progress merge request"),
 });
 export const GetMergeRequestDiffsSchema = GetMergeRequestSchema.extend({
@@ -722,38 +725,14 @@ 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
@@ -765,18 +744,9 @@ export const ListIssuesSchema = z.object({
         .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"),
+    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"),
 });
@@ -791,10 +761,7 @@ export const ListMergeRequestsSchema = z.object({
         .string()
         .optional()
         .describe("Returns merge requests assigned to the given username"),
-    author_id: z
-        .number()
-        .optional()
-        .describe("Returns merge requests created by the given user ID"),
+    author_id: z.number().optional().describe("Returns merge requests created by the given user ID"),
     author_username: z
         .string()
         .optional()
@@ -850,14 +817,8 @@ export const ListMergeRequestsSchema = z.object({
         .string()
         .optional()
         .describe("Return merge requests from a specific source branch"),
-    wip: z
-        .enum(["yes", "no"])
-        .optional()
-        .describe("Filter merge requests against their wip status"),
-    with_labels_details: z
-        .boolean()
-        .optional()
-        .describe("Return more details for each label"),
+    wip: z.enum(["yes", "no"]).optional().describe("Filter merge requests against their wip status"),
+    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"),
 });
@@ -870,28 +831,13 @@ 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({
@@ -913,8 +859,14 @@ export const ListIssueDiscussionsSchema = z.object({
     issue_iid: z.number().describe("The internal ID of the project issue"),
     page: z.number().optional().describe("Page number for pagination"),
     per_page: z.number().optional().describe("Number of items per page"),
-    sort: z.enum(["asc", "desc"]).optional().describe("Return issue discussions sorted in ascending or descending order"),
-    order_by: z.enum(["created_at", "updated_at"]).optional().describe("Return issue discussions ordered by created_at or updated_at fields"),
+    sort: z
+        .enum(["asc", "desc"])
+        .optional()
+        .describe("Return issue discussions sorted in ascending or descending order"),
+    order_by: z
+        .enum(["created_at", "updated_at"])
+        .optional()
+        .describe("Return issue discussions ordered by created_at or updated_at fields"),
 });
 export const GetIssueLinkSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
@@ -924,12 +876,8 @@ 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"),
+    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()
@@ -945,10 +893,7 @@ 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"),
@@ -964,18 +909,9 @@ 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"),
-    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"),
+    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
@@ -983,14 +919,7 @@ export const ListProjectsSchema = z.object({
         .optional()
         .describe("Filter by project visibility"),
     order_by: z
-        .enum([
-        "id",
-        "name",
-        "path",
-        "created_at",
-        "updated_at",
-        "last_activity_at",
-    ])
+        .enum(["id", "name", "path", "created_at", "updated_at", "last_activity_at"])
         .optional()
         .describe("Return projects ordered by field"),
     sort: z
@@ -1005,10 +934,7 @@ export const ListProjectsSchema = z.object({
         .boolean()
         .optional()
         .describe("Filter projects with merge requests feature enabled"),
-    min_access_level: z
-        .number()
-        .optional()
-        .describe("Filter by minimum access level"),
+    min_access_level: z.number().optional().describe("Filter by minimum access level"),
 });
 // Label operation schemas
 export const ListLabelsSchema = z.object({
@@ -1017,19 +943,13 @@ export const ListLabelsSchema = z.object({
         .boolean()
         .optional()
         .describe("Whether or not to include issue and merge request counts"),
-    include_ancestor_groups: z
-        .boolean()
-        .optional()
-        .describe("Include ancestor groups"),
+    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.string().describe("The ID or title of a project's label"),
-    include_ancestor_groups: z
-        .boolean()
-        .optional()
-        .describe("Include ancestor groups"),
+    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"),
@@ -1038,11 +958,7 @@ export const CreateLabelSchema = z.object({
         .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"),
@@ -1052,15 +968,8 @@ export const UpdateLabelSchema = z.object({
         .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"),
+    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"),
@@ -1069,10 +978,7 @@ export const DeleteLabelSchema = z.object({
 // 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"])
@@ -1094,24 +1000,12 @@ export const ListGroupProjectsSchema = z.object({
         .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"),
+    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({
@@ -1127,20 +1021,14 @@ 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"),
@@ -1181,12 +1069,27 @@ export const CreateMergeRequestThreadSchema = ProjectParamsSchema.extend({
 // Schema for listing project milestones
 export const ListProjectMilestonesSchema = ProjectParamsSchema.extend({
     iids: z.array(z.number()).optional().describe("Return only the milestones having the given iid"),
-    state: z.enum(["active", "closed"]).optional().describe("Return only active or closed milestones"),
-    title: z.string().optional().describe("Return only milestones with a title matching the provided string"),
-    search: z.string().optional().describe("Return only milestones with a title or description matching the provided string"),
+    state: z
+        .enum(["active", "closed"])
+        .optional()
+        .describe("Return only active or closed milestones"),
+    title: z
+        .string()
+        .optional()
+        .describe("Return only milestones with a title matching the provided string"),
+    search: z
+        .string()
+        .optional()
+        .describe("Return only milestones with a title or description matching the provided string"),
     include_ancestors: z.boolean().optional().describe("Include ancestor groups"),
-    updated_before: z.string().optional().describe("Return milestones updated before the specified date (ISO 8601 format)"),
-    updated_after: z.string().optional().describe("Return milestones updated after the specified date (ISO 8601 format)"),
+    updated_before: z
+        .string()
+        .optional()
+        .describe("Return milestones updated before the specified date (ISO 8601 format)"),
+    updated_after: z
+        .string()
+        .optional()
+        .describe("Return milestones updated after the specified date (ISO 8601 format)"),
     page: z.number().optional().describe("Page number for pagination"),
     per_page: z.number().optional().describe("Number of items per page (max 100)"),
 });
@@ -1207,7 +1110,10 @@ export const EditProjectMilestoneSchema = GetProjectMilestoneSchema.extend({
     description: z.string().optional().describe("The description of the milestone"),
     due_date: z.string().optional().describe("The due date of the milestone (YYYY-MM-DD)"),
     start_date: z.string().optional().describe("The start date of the milestone (YYYY-MM-DD)"),
-    state_event: z.enum(["close", "activate"]).optional().describe("The state event of the milestone"),
+    state_event: z
+        .enum(["close", "activate"])
+        .optional()
+        .describe("The state event of the milestone"),
 });
 // Schema for deleting a milestone
 export const DeleteProjectMilestoneSchema = GetProjectMilestoneSchema;

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

@@ -1,18 +1,18 @@
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
+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');
+    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');
+    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');
+        console.error("Unable to locate allTools array in index.ts");
         process.exit(1);
     }
     const toolsBlock = match[1];
@@ -27,13 +27,13 @@ async function main() {
     const lines = tools.map((tool, index) => {
         return `${index + 1}. \`${tool.name}\` - ${tool.description}`;
     });
-    const markdown = lines.join('\n');
+    const markdown = lines.join("\n");
     // 5. Read README.md and replace between markers
-    const readme = fs.readFileSync(readmePath, 'utf-8');
+    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.');
+    fs.writeFileSync(readmePath, updated, "utf-8");
+    console.log("README.md tools section updated.");
 }
 main().catch(err => {
     console.error(err);

package/build/tests/integration.test.js

@@ -0,0 +1,151 @@
+import { describe, it, expect, beforeAll, afterAll } from '@jest/globals';
+import fetch from 'node-fetch';
+// Integration tests that run against real GitLab API (when credentials are provided)
+const GITLAB_API_URL = process.env.GITLAB_API_URL || 'https://gitlab.com';
+const GITLAB_TOKEN = process.env.GITLAB_TOKEN || '';
+const TEST_PROJECT_ID = process.env.TEST_PROJECT_ID || '';
+const skipIntegrationTests = !GITLAB_TOKEN || !TEST_PROJECT_ID;
+describe('GitLab MCP Server Integration Tests', () => {
+    if (skipIntegrationTests) {
+        it('should skip integration tests when credentials are missing', () => {
+            console.log('Skipping integration tests: Missing GITLAB_TOKEN or TEST_PROJECT_ID');
+            expect(true).toBe(true);
+        });
+        return;
+    }
+    let testIssueId = null;
+    let testMRId = null;
+    beforeAll(() => {
+        console.log('Running integration tests with GitLab API');
+    });
+    afterAll(async () => {
+        // Cleanup: Delete test issue and MR if created
+        if (testIssueId) {
+            await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}/issues/${testIssueId}`, {
+                method: 'DELETE',
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`
+                }
+            });
+        }
+    });
+    describe('Project Access', () => {
+        it('should fetch project information', async () => {
+            const response = await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}`, {
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`,
+                    'Accept': 'application/json'
+                }
+            });
+            expect(response.ok).toBe(true);
+            const project = await response.json();
+            expect(project).toHaveProperty('id');
+            expect(project).toHaveProperty('name');
+        });
+    });
+    describe('Issue Operations', () => {
+        it('should create an issue', async () => {
+            const issueData = {
+                title: `Test Issue ${Date.now()}`,
+                description: 'This is a test issue created by MCP integration tests'
+            };
+            const response = await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}/issues`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`,
+                    'Accept': 'application/json',
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(issueData)
+            });
+            expect(response.ok).toBe(true);
+            const issue = await response.json();
+            expect(issue).toHaveProperty('iid');
+            expect(issue.title).toBe(issueData.title);
+            testIssueId = issue.iid;
+        });
+        it('should list issues', async () => {
+            const response = await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}/issues?state=opened`, {
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`,
+                    'Accept': 'application/json'
+                }
+            });
+            expect(response.ok).toBe(true);
+            const issues = await response.json();
+            expect(Array.isArray(issues)).toBe(true);
+        });
+        it('should add a comment to an issue', async () => {
+            if (!testIssueId) {
+                console.log('Skipping comment test: No test issue created');
+                return;
+            }
+            const commentData = {
+                body: 'Test comment from MCP integration tests'
+            };
+            const response = await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}/issues/${testIssueId}/notes`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`,
+                    'Accept': 'application/json',
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(commentData)
+            });
+            expect(response.ok).toBe(true);
+            const comment = await response.json();
+            expect(comment.body).toBe(commentData.body);
+        });
+    });
+    describe('Merge Request Operations', () => {
+        it('should list merge requests', async () => {
+            const response = await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}/merge_requests?state=opened`, {
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`,
+                    'Accept': 'application/json'
+                }
+            });
+            expect(response.ok).toBe(true);
+            const mrs = await response.json();
+            expect(Array.isArray(mrs)).toBe(true);
+        });
+    });
+    describe('Repository Operations', () => {
+        it('should fetch repository branches', async () => {
+            const response = await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}/repository/branches`, {
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`,
+                    'Accept': 'application/json'
+                }
+            });
+            expect(response.ok).toBe(true);
+            const branches = await response.json();
+            expect(Array.isArray(branches)).toBe(true);
+            expect(branches.length).toBeGreaterThan(0);
+        });
+        it('should fetch repository commits', async () => {
+            const response = await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}/repository/commits?per_page=5`, {
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`,
+                    'Accept': 'application/json'
+                }
+            });
+            expect(response.ok).toBe(true);
+            const commits = await response.json();
+            expect(Array.isArray(commits)).toBe(true);
+        });
+    });
+    describe('Pipeline Operations', () => {
+        it('should list pipelines', async () => {
+            const response = await fetch(`${GITLAB_API_URL}/api/v4/projects/${encodeURIComponent(TEST_PROJECT_ID)}/pipelines?per_page=5`, {
+                headers: {
+                    'Authorization': `Bearer ${GITLAB_TOKEN}`,
+                    'Accept': 'application/json'
+                }
+            });
+            expect(response.ok).toBe(true);
+            const pipelines = await response.json();
+            expect(Array.isArray(pipelines)).toBe(true);
+        });
+    });
+});

package/build/tests/unit.test.js

@@ -0,0 +1,122 @@
+import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
+import fetch from 'node-fetch';
+// Mock fetch for unit tests
+jest.mock('node-fetch');
+const mockedFetch = fetch;
+describe('GitLab MCP Server Unit Tests', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    describe('API URL Construction', () => {
+        it('should use plural resource names in API endpoints', () => {
+            const projectId = 'test/project';
+            const issueIid = 123;
+            // Test issue endpoint
+            const issueUrl = `/api/v4/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`;
+            expect(issueUrl).toContain('/issues/');
+            expect(issueUrl).not.toContain('/issue/');
+            // Test merge request endpoint
+            const mrUrl = `/api/v4/projects/${encodeURIComponent(projectId)}/merge_requests/${issueIid}`;
+            expect(mrUrl).toContain('/merge_requests/');
+            expect(mrUrl).not.toContain('/merge_request/');
+        });
+        it('should properly encode project IDs with special characters', () => {
+            const projectId = 'namespace/project-name';
+            const encoded = encodeURIComponent(projectId);
+            expect(encoded).toBe('namespace%2Fproject-name');
+        });
+    });
+    describe('API Response Handling', () => {
+        it('should handle successful responses', async () => {
+            const mockResponse = {
+                ok: true,
+                status: 200,
+                json: async () => ({ id: 1, title: 'Test Issue' })
+            };
+            mockedFetch.mockResolvedValueOnce(mockResponse);
+            const response = await fetch('https://gitlab.com/api/v4/projects/1/issues/1');
+            const data = await response.json();
+            expect(response.ok).toBe(true);
+            expect(data).toEqual({ id: 1, title: 'Test Issue' });
+        });
+        it('should handle error responses', async () => {
+            const mockResponse = {
+                ok: false,
+                status: 404,
+                statusText: 'Not Found',
+                text: async () => '{"message":"404 Project Not Found"}'
+            };
+            mockedFetch.mockResolvedValueOnce(mockResponse);
+            const response = await fetch('https://gitlab.com/api/v4/projects/999/issues/1');
+            expect(response.ok).toBe(false);
+            expect(response.status).toBe(404);
+        });
+        it('should handle rate limiting', async () => {
+            const mockResponse = {
+                ok: false,
+                status: 429,
+                statusText: 'Too Many Requests',
+                headers: {
+                    get: (name) => name === 'RateLimit-Reset' ? '1234567890' : null
+                }
+            };
+            mockedFetch.mockResolvedValueOnce(mockResponse);
+            const response = await fetch('https://gitlab.com/api/v4/projects/1/issues');
+            expect(response.status).toBe(429);
+        });
+    });
+    describe('Authentication', () => {
+        it('should include Bearer token in Authorization header', () => {
+            const token = 'test-token-123';
+            const headers = {
+                'Authorization': `Bearer ${token}`,
+                'Accept': 'application/json',
+                'Content-Type': 'application/json'
+            };
+            expect(headers.Authorization).toBe('Bearer test-token-123');
+        });
+        it('should handle missing token gracefully', () => {
+            const token = process.env.GITLAB_TOKEN || '';
+            expect(token).toBeDefined();
+        });
+    });
+    describe('Data Validation', () => {
+        it('should validate required fields for issue creation', () => {
+            const validIssue = {
+                title: 'Test Issue',
+                description: 'Test Description'
+            };
+            expect(validIssue.title).toBeTruthy();
+            expect(validIssue.title.length).toBeGreaterThan(0);
+        });
+        it('should validate merge request parameters', () => {
+            const validMR = {
+                source_branch: 'feature-branch',
+                target_branch: 'main',
+                title: 'Test MR'
+            };
+            expect(validMR.source_branch).not.toBe(validMR.target_branch);
+            expect(validMR.title).toBeTruthy();
+        });
+    });
+    describe('Error Handling', () => {
+        it('should handle network errors', async () => {
+            mockedFetch.mockRejectedValueOnce(new Error('Network error'));
+            await expect(fetch('https://gitlab.com/api/v4/projects/1/issues'))
+                .rejects.toThrow('Network error');
+        });
+        it('should handle JSON parsing errors', async () => {
+            const mockResponse = {
+                ok: true,
+                status: 200,
+                json: async () => { throw new Error('Invalid JSON'); }
+            };
+            mockedFetch.mockResolvedValueOnce(mockResponse);
+            const response = await fetch('https://gitlab.com/api/v4/projects/1/issues');
+            await expect(response.json()).rejects.toThrow('Invalid JSON');
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "1.0.50",
+  "version": "1.0.51",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",
@@ -20,7 +20,13 @@
     "prepare": "npm run build",
     "watch": "tsc --watch",
     "deploy": "npm publish --access public",
-    "generate-tools": "npx ts-node scripts/generate-tools-readme.ts"
+    "generate-tools": "npx ts-node scripts/generate-tools-readme.ts",
+    "test": "node test/validate-api.js",
+    "test:integration": "node test/validate-api.js",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "format": "prettier --write \"**/*.{js,ts,json,md}\"",
+    "format:check": "prettier --check \"**/*.{js,ts,json,md}\""
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.8.0",
@@ -35,6 +41,11 @@
   "devDependencies": {
     "@types/node": "^22.13.10",
     "typescript": "^5.8.2",
-    "zod": "^3.24.2"
+    "zod": "^3.24.2",
+    "@typescript-eslint/eslint-plugin": "^8.21.0",
+    "@typescript-eslint/parser": "^8.21.0",
+    "eslint": "^9.18.0",
+    "prettier": "^3.4.2",
+    "ts-node": "^10.9.2"
   }
 }