@zereight/mcp-gitlab 1.0.31 → 1.0.32

package/build/index.js

@@ -13,7 +13,7 @@ import { dirname } from "path";
 import fs from "fs";
 import path from "path";
 import { URL } from 'url';
-import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabIssueSchema, GitLabMergeRequestSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabSearchResponseSchema, GitLabTreeSchema, GitLabCommitSchema, GitLabNamespaceSchema, GitLabNamespaceExistsResponseSchema, GitLabProjectSchema, CreateOrUpdateFileSchema, SearchRepositoriesSchema, CreateRepositorySchema, GetFileContentsSchema, PushFilesSchema, CreateIssueSchema, CreateMergeRequestSchema, ForkRepositorySchema, CreateBranchSchema, GitLabMergeRequestDiffSchema, GetMergeRequestSchema, GetMergeRequestDiffsSchema, UpdateMergeRequestSchema, ListIssuesSchema, GetIssueSchema, UpdateIssueSchema, DeleteIssueSchema, GitLabIssueLinkSchema, GitLabIssueWithLinkDetailsSchema, ListIssueLinksSchema, GetIssueLinkSchema, CreateIssueLinkSchema, DeleteIssueLinkSchema, ListNamespacesSchema, GetNamespaceSchema, VerifyNamespaceSchema, GetProjectSchema, ListProjectsSchema, ListLabelsSchema, GetLabelSchema, CreateLabelSchema, UpdateLabelSchema, DeleteLabelSchema, CreateNoteSchema, ListGroupProjectsSchema, 
+import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabIssueSchema, GitLabMergeRequestSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabSearchResponseSchema, GitLabTreeSchema, GitLabCommitSchema, GitLabNamespaceSchema, GitLabNamespaceExistsResponseSchema, GitLabProjectSchema, CreateOrUpdateFileSchema, SearchRepositoriesSchema, CreateRepositorySchema, GetFileContentsSchema, PushFilesSchema, CreateIssueSchema, CreateMergeRequestSchema, ForkRepositorySchema, CreateBranchSchema, GitLabMergeRequestDiffSchema, GetMergeRequestSchema, GetMergeRequestDiffsSchema, UpdateMergeRequestSchema, ListIssuesSchema, GetIssueSchema, UpdateIssueSchema, DeleteIssueSchema, GitLabIssueLinkSchema, GitLabIssueWithLinkDetailsSchema, ListIssueLinksSchema, GetIssueLinkSchema, CreateIssueLinkSchema, DeleteIssueLinkSchema, ListNamespacesSchema, GetNamespaceSchema, VerifyNamespaceSchema, GetProjectSchema, ListProjectsSchema, ListLabelsSchema, GetLabelSchema, CreateLabelSchema, UpdateLabelSchema, DeleteLabelSchema, CreateNoteSchema, ListGroupProjectsSchema, ListWikiPagesSchema, GetWikiPageSchema, CreateWikiPageSchema, UpdateWikiPageSchema, DeleteWikiPageSchema, GitLabWikiPageSchema, 
 // Discussion Schemas
 GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, UpdateMergeRequestNoteSchema, // Added
@@ -44,6 +44,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";
 // Add proxy configuration
 const HTTP_PROXY = process.env.HTTP_PROXY;
 const HTTPS_PROXY = process.env.HTTPS_PROXY;
@@ -150,7 +151,7 @@ const allTools = [
         inputSchema: zodToJsonSchema(CreateNoteSchema),
     },
     {
-        name: "list_merge_request_discussions",
+        name: "mr_discussions",
         description: "List discussion items for a merge request",
         inputSchema: zodToJsonSchema(ListMergeRequestDiscussionsSchema),
     },
@@ -254,6 +255,31 @@ const allTools = [
         description: "List projects in a GitLab group with filtering options",
         inputSchema: zodToJsonSchema(ListGroupProjectsSchema),
     },
+    {
+        name: "list_wiki_pages",
+        description: "List wiki pages in a GitLab project",
+        inputSchema: zodToJsonSchema(ListWikiPagesSchema),
+    },
+    {
+        name: "get_wiki_page",
+        description: "Get details of a specific wiki page",
+        inputSchema: zodToJsonSchema(GetWikiPageSchema),
+    },
+    {
+        name: "create_wiki_page",
+        description: "Create a new wiki page in a GitLab project",
+        inputSchema: zodToJsonSchema(CreateWikiPageSchema),
+    },
+    {
+        name: "update_wiki_page",
+        description: "Update an existing wiki page in a GitLab project",
+        inputSchema: zodToJsonSchema(UpdateWikiPageSchema),
+    },
+    {
+        name: "delete_wiki_page",
+        description: "Delete a wiki page from a GitLab project",
+        inputSchema: zodToJsonSchema(DeleteWikiPageSchema),
+    }
 ];
 // Define which tools are read-only
 const readOnlyTools = [
@@ -261,7 +287,7 @@ const readOnlyTools = [
     "get_file_contents",
     "get_merge_request",
     "get_merge_request_diffs",
-    "list_merge_request_discussions",
+    "mr_discussions",
     "list_issues",
     "get_issue",
     "list_issue_links",
@@ -275,6 +301,15 @@ const readOnlyTools = [
     "get_label",
     "list_group_projects",
 ];
+// Define which tools are related to wiki and can be toggled by USE_GITLAB_WIKI
+const wikiToolNames = [
+    "list_wiki_pages",
+    "get_wiki_page",
+    "create_wiki_page",
+    "update_wiki_page",
+    "delete_wiki_page",
+    "upload_wiki_attachment",
+];
 /**
  * Smart URL handling for GitLab API
  *
@@ -1262,11 +1297,87 @@ async function listGroupProjects(options) {
     const projects = await response.json();
     return GitLabProjectSchema.array().parse(projects);
 }
+// Wiki API helper functions
+/**
+ * List wiki pages in a project
+ */
+async function listWikiPages(projectId, options = {}) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis`);
+    if (options.page)
+        url.searchParams.append('page', options.page.toString());
+    if (options.per_page)
+        url.searchParams.append('per_page', options.per_page.toString());
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabWikiPageSchema.array().parse(data);
+}
+/**
+ * Get a specific wiki page
+ */
+async function getWikiPage(projectId, slug) {
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, { ...DEFAULT_FETCH_CONFIG });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabWikiPageSchema.parse(data);
+}
+/**
+ * Create a new wiki page
+ */
+async function createWikiPage(projectId, title, content, format) {
+    const body = { title, content };
+    if (format)
+        body.format = format;
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis`, {
+        ...DEFAULT_FETCH_CONFIG,
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabWikiPageSchema.parse(data);
+}
+/**
+ * Update an existing wiki page
+ */
+async function updateWikiPage(projectId, slug, title, content, format) {
+    const body = {};
+    if (title)
+        body.title = title;
+    if (content)
+        body.content = content;
+    if (format)
+        body.format = format;
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, {
+        ...DEFAULT_FETCH_CONFIG,
+        method: 'PUT',
+        body: JSON.stringify(body),
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabWikiPageSchema.parse(data);
+}
+/**
+ * Delete a wiki page
+ */
+async function deleteWikiPage(projectId, slug) {
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, {
+        ...DEFAULT_FETCH_CONFIG,
+        method: 'DELETE',
+    });
+    await handleGitLabError(response);
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-    // If read-only mode is enabled, filter out write operations
-    const tools = GITLAB_READ_ONLY_MODE
+    // Apply read-only filter first
+    const tools0 = GITLAB_READ_ONLY_MODE
         ? allTools.filter((tool) => readOnlyTools.includes(tool.name))
         : allTools;
+    // Toggle wiki tools by USE_GITLAB_WIKI flag
+    const tools = USE_GITLAB_WIKI
+        ? tools0
+        : tools0.filter((tool) => !wikiToolNames.includes(tool.name));
     return {
         tools,
     };
@@ -1406,7 +1517,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
-            case "list_merge_request_discussions": {
+            case "mr_discussions": {
                 const args = ListMergeRequestDiscussionsSchema.parse(request.params.arguments);
                 const discussions = await listMergeRequestDiscussions(args.project_id, args.merge_request_iid);
                 return {
@@ -1617,6 +1728,31 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(projects, null, 2) }],
                 };
             }
+            case "list_wiki_pages": {
+                const { project_id, page, per_page } = ListWikiPagesSchema.parse(request.params.arguments);
+                const wikiPages = await listWikiPages(project_id, { page, per_page });
+                return { content: [{ type: "text", text: JSON.stringify(wikiPages, null, 2) }] };
+            }
+            case "get_wiki_page": {
+                const { project_id, slug } = GetWikiPageSchema.parse(request.params.arguments);
+                const wikiPage = await getWikiPage(project_id, slug);
+                return { content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }] };
+            }
+            case "create_wiki_page": {
+                const { project_id, title, content, format } = CreateWikiPageSchema.parse(request.params.arguments);
+                const wikiPage = await createWikiPage(project_id, title, content, format);
+                return { content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }] };
+            }
+            case "update_wiki_page": {
+                const { project_id, slug, title, content, format } = UpdateWikiPageSchema.parse(request.params.arguments);
+                const wikiPage = await updateWikiPage(project_id, slug, title, content, format);
+                return { content: [{ type: "text", text: JSON.stringify(wikiPage, null, 2) }] };
+            }
+            case "delete_wiki_page": {
+                const { project_id, slug } = DeleteWikiPageSchema.parse(request.params.arguments);
+                await deleteWikiPage(project_id, slug);
+                return { content: [{ type: "text", text: JSON.stringify({ status: "success", message: "Wiki page deleted successfully" }, null, 2) }] };
+            }
             default:
                 throw new Error(`Unknown tool: ${request.params.name}`);
         }

package/build/schemas.js

@@ -682,3 +682,39 @@ export const ListGroupProjectsSchema = z.object({
     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({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    page: z.number().optional().describe("Page number for pagination"),
+    per_page: z.number().optional().describe("Number of items per page"),
+});
+export const GetWikiPageSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    slug: z.string().describe("URL-encoded slug of the wiki page"),
+});
+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"),
+});
+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"),
+});
+export const DeleteWikiPageSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    slug: z.string().describe("URL-encoded slug of the wiki page"),
+});
+// Define wiki response schemas
+export const GitLabWikiPageSchema = z.object({
+    title: z.string(),
+    slug: z.string(),
+    format: z.string(),
+    content: z.string(),
+    created_at: z.string().optional(),
+    updated_at: z.string().optional(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "1.0.31",
+  "version": "1.0.32",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",
@@ -23,6 +23,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.8.0",
+    "form-data": "^4.0.0",
     "@types/node-fetch": "^2.6.12",
     "http-proxy-agent": "^7.0.2",
     "https-proxy-agent": "^7.0.6",