@zereight/mcp-gitlab 1.0.35 → 1.0.37

package/README.md

@@ -55,31 +55,33 @@ When using with the Claude App, you need to set up your API key and URLs directl
 11. `get_merge_request_diffs` - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)
 12. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)
 13. `create_note` - Create a new note (comment) to an issue or merge request
-14. `mr_discussions` - List discussion items for a merge request
-15. `update_merge_request_note` - Modify an existing merge request thread note
-16. `list_issues` - List issues in a GitLab project with filtering options
-17. `get_issue` - Get details of a specific issue in a GitLab project
-18. `update_issue` - Update an issue in a GitLab project
-19. `delete_issue` - Delete an issue from a GitLab project
-20. `list_issue_links` - List all issue links for a specific issue
-21. `get_issue_link` - Get a specific issue link
-22. `create_issue_link` - Create an issue link between two issues
-23. `delete_issue_link` - Delete an issue link
-24. `list_namespaces` - List all namespaces available to the current user
-25. `get_namespace` - Get details of a namespace by ID or path
-26. `verify_namespace` - Verify if a namespace path exists
-27. `get_project` - Get details of a specific project
-28. `list_projects` - List projects accessible by the current user
-29. `list_labels` - List labels for a project
-30. `get_label` - Get a single label from a project
-31. `create_label` - Create a new label in a project
-32. `update_label` - Update an existing label in a project
-33. `delete_label` - Delete a label from a project
-34. `list_group_projects` - List projects in a GitLab group with filtering options
-35. `list_wiki_pages` - List wiki pages in a GitLab project
-36. `get_wiki_page` - Get details of a specific wiki page
-37. `create_wiki_page` - Create a new wiki page in a GitLab project
-38. `update_wiki_page` - Update an existing wiki page in a GitLab project
-39. `delete_wiki_page` - Delete a wiki page from a GitLab project
-40. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
+14. `create_merge_request_thread` - Create a new thread on a merge request
+15. `mr_discussions` - List discussion items for a merge request
+16. `update_merge_request_note` - Modify an existing merge request thread note
+17. `create_merge_request_note` - Add a new note to an existing merge request thread
+18. `list_issues` - List issues in a GitLab project with filtering options
+19. `get_issue` - Get details of a specific issue in a GitLab project
+20. `update_issue` - Update an issue in a GitLab project
+21. `delete_issue` - Delete an issue from a GitLab project
+22. `list_issue_links` - List all issue links for a specific issue
+23. `get_issue_link` - Get a specific issue link
+24. `create_issue_link` - Create an issue link between two issues
+25. `delete_issue_link` - Delete an issue link
+26. `list_namespaces` - List all namespaces available to the current user
+27. `get_namespace` - Get details of a namespace by ID or path
+28. `verify_namespace` - Verify if a namespace path exists
+29. `get_project` - Get details of a specific project
+30. `list_projects` - List projects accessible by the current user
+31. `list_labels` - List labels for a project
+32. `get_label` - Get a single label from a project
+33. `create_label` - Create a new label in a project
+34. `update_label` - Update an existing label in a project
+35. `delete_label` - Delete a label from a project
+36. `list_group_projects` - List projects in a GitLab group with filtering options
+37. `list_wiki_pages` - List wiki pages in a GitLab project
+38. `get_wiki_page` - Get details of a specific wiki page
+39. `create_wiki_page` - Create a new wiki page in a GitLab project
+40. `update_wiki_page` - Update an existing wiki page in a GitLab project
+41. `delete_wiki_page` - Delete a wiki page from a GitLab project
+42. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
 <!-- TOOLS-END -->

package/build/index.js

@@ -13,10 +13,11 @@ 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, ListWikiPagesSchema, GetWikiPageSchema, CreateWikiPageSchema, UpdateWikiPageSchema, DeleteWikiPageSchema, GitLabWikiPageSchema, 
+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, CreateMergeRequestThreadSchema, ListGroupProjectsSchema, ListWikiPagesSchema, GetWikiPageSchema, CreateWikiPageSchema, UpdateWikiPageSchema, DeleteWikiPageSchema, GitLabWikiPageSchema, 
 // Discussion Schemas
 GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, UpdateMergeRequestNoteSchema, // Added
+CreateMergeRequestNoteSchema, // Added
 ListMergeRequestDiscussionsSchema, GitLabTreeItemSchema, GetRepositoryTreeSchema, } from "./schemas.js";
 /**
  * Read version from package.json
@@ -150,6 +151,11 @@ const allTools = [
         description: "Create a new note (comment) to an issue or merge request",
         inputSchema: zodToJsonSchema(CreateNoteSchema),
     },
+    {
+        name: "create_merge_request_thread",
+        description: "Create a new thread on a merge request",
+        inputSchema: zodToJsonSchema(CreateMergeRequestThreadSchema),
+    },
     {
         name: "mr_discussions",
         description: "List discussion items for a merge request",
@@ -160,6 +166,11 @@ const allTools = [
         description: "Modify an existing merge request thread note",
         inputSchema: zodToJsonSchema(UpdateMergeRequestNoteSchema),
     },
+    {
+        name: "create_merge_request_note",
+        description: "Add a new note to an existing merge request thread",
+        inputSchema: zodToJsonSchema(CreateMergeRequestNoteSchema),
+    },
     {
         name: "list_issues",
         description: "List issues in a GitLab project with filtering options",
@@ -373,6 +384,7 @@ async function handleGitLabError(response) {
  * @returns {Promise<GitLabFork>} The created fork
  */
 async function forkProject(projectId, namespace) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/fork`);
     if (namespace) {
         url.searchParams.append("namespace", namespace);
@@ -398,6 +410,7 @@ async function forkProject(projectId, namespace) {
  * @returns {Promise<GitLabReference>} The created branch reference
  */
 async function createBranch(projectId, options) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/repository/branches`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -418,6 +431,7 @@ async function createBranch(projectId, options) {
  * @returns {Promise<string>} The name of the default branch
  */
 async function getDefaultBranchRef(projectId) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -436,6 +450,7 @@ async function getDefaultBranchRef(projectId) {
  * @returns {Promise<GitLabContent>} The file content
  */
 async function getFileContents(projectId, filePath, ref) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const encodedPath = encodeURIComponent(filePath);
     // ref가 없는 경우 default branch를 가져옴
     if (!ref) {
@@ -469,6 +484,7 @@ async function getFileContents(projectId, filePath, ref) {
  * @returns {Promise<GitLabIssue>} The created issue
  */
 async function createIssue(projectId, options) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -499,6 +515,7 @@ async function createIssue(projectId, options) {
  * @returns {Promise<GitLabIssue[]>} List of issues
  */
 async function listIssues(projectId, options = {}) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues`);
     // Add all query parameters
     Object.entries(options).forEach(([key, value]) => {
@@ -528,6 +545,7 @@ async function listIssues(projectId, options = {}) {
  * @returns {Promise<GitLabIssue>} The issue
  */
 async function getIssue(projectId, issueIid) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -546,6 +564,7 @@ async function getIssue(projectId, issueIid) {
  * @returns {Promise<GitLabIssue>} The updated issue
  */
 async function updateIssue(projectId, issueIid, options) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
     // Convert labels array to comma-separated string if present
     const body = { ...options };
@@ -570,6 +589,7 @@ async function updateIssue(projectId, issueIid, options) {
  * @returns {Promise<void>}
  */
 async function deleteIssue(projectId, issueIid) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -586,6 +606,7 @@ async function deleteIssue(projectId, issueIid) {
  * @returns {Promise<GitLabIssueWithLinkDetails[]>} List of issues with link details
  */
 async function listIssueLinks(projectId, issueIid) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/links`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -604,6 +625,7 @@ async function listIssueLinks(projectId, issueIid) {
  * @returns {Promise<GitLabIssueLink>} The issue link
  */
 async function getIssueLink(projectId, issueIid, issueLinkId) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/links/${issueLinkId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -624,6 +646,8 @@ async function getIssueLink(projectId, issueIid, issueLinkId) {
  * @returns {Promise<GitLabIssueLink>} The created issue link
  */
 async function createIssueLink(projectId, issueIid, targetProjectId, targetIssueIid, linkType = "relates_to") {
+    projectId = decodeURIComponent(projectId); // Decode project ID
+    targetProjectId = decodeURIComponent(targetProjectId); // Decode target project ID as well
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/links`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -648,6 +672,7 @@ async function createIssueLink(projectId, issueIid, targetProjectId, targetIssue
  * @returns {Promise<void>}
  */
 async function deleteIssueLink(projectId, issueIid, issueLinkId) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/links/${issueLinkId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -664,6 +689,7 @@ async function deleteIssueLink(projectId, issueIid, issueLinkId) {
  * @returns {Promise<GitLabMergeRequest>} The created merge request
  */
 async function createMergeRequest(projectId, options) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -697,6 +723,7 @@ async function createMergeRequest(projectId, options) {
  * @returns {Promise<GitLabDiscussion[]>} List of discussions
  */
 async function listMergeRequestDiscussions(projectId, mergeRequestIid) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/discussions`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -719,9 +746,14 @@ async function listMergeRequestDiscussions(projectId, mergeRequestIid) {
  * @returns {Promise<GitLabDiscussionNote>} The updated note
  */
 async function updateMergeRequestNote(projectId, mergeRequestIid, discussionId, noteId, body, resolved) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/discussions/${discussionId}/notes/${noteId}`);
-    const payload = { body };
-    if (resolved !== undefined) {
+    // Only one of body or resolved can be sent according to GitLab API
+    const payload = {};
+    if (body !== undefined) {
+        payload.body = body;
+    }
+    else if (resolved !== undefined) {
         payload.resolved = resolved;
     }
     const response = await fetch(url.toString(), {
@@ -733,6 +765,33 @@ async function updateMergeRequestNote(projectId, mergeRequestIid, discussionId,
     const data = await response.json();
     return GitLabDiscussionNoteSchema.parse(data);
 }
+/**
+ * Add a new note to an existing merge request thread
+ * 기존 병합 요청 스레드에 새 노트 추가
+ *
+ * @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 {string} body - The content of the new note
+ * @param {string} [createdAt] - The creation date of the note (ISO 8601 format)
+ * @returns {Promise<GitLabDiscussionNote>} The created note
+ */
+async function createMergeRequestNote(projectId, mergeRequestIid, discussionId, body, createdAt) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/discussions/${discussionId}/notes`);
+    const payload = { body };
+    if (createdAt) {
+        payload.created_at = createdAt;
+    }
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+        method: "POST",
+        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
  * 파일 생성 또는 업데이트
@@ -746,6 +805,7 @@ async function updateMergeRequestNote(projectId, mergeRequestIid, discussionId,
  * @returns {Promise<GitLabCreateUpdateFileResponse>} The file update response
  */
 async function createOrUpdateFile(projectId, filePath, content, commitMessage, branch, previousPath, last_commit_id, commit_id) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const encodedPath = encodeURIComponent(filePath);
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/repository/files/${encodedPath}`);
     const body = {
@@ -813,6 +873,7 @@ async function createOrUpdateFile(projectId, filePath, content, commitMessage, b
  * @returns {Promise<GitLabTree>} The created tree
  */
 async function createTree(projectId, files, ref) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/repository/tree`);
     if (ref) {
         url.searchParams.append("ref", ref);
@@ -850,6 +911,7 @@ async function createTree(projectId, files, ref) {
  * @returns {Promise<GitLabCommit>} The created commit
  */
 async function createCommit(projectId, message, branch, actions) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/repository/commits`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -948,6 +1010,7 @@ async function createRepository(options) {
  * @returns {Promise<GitLabMergeRequest>} The merge request details
  */
 async function getMergeRequest(projectId, mergeRequestIid, branchName) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     let url;
     if (mergeRequestIid) {
         url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}`);
@@ -980,6 +1043,7 @@ async function getMergeRequest(projectId, mergeRequestIid, branchName) {
  * @returns {Promise<GitLabMergeRequestDiff[]>} The merge request diffs
  */
 async function getMergeRequestDiffs(projectId, mergeRequestIid, branchName, view) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     if (!mergeRequestIid && !branchName) {
         throw new Error("Either mergeRequestIid or branchName must be provided");
     }
@@ -1009,6 +1073,7 @@ async function getMergeRequestDiffs(projectId, mergeRequestIid, branchName, view
  * @returns {Promise<GitLabMergeRequest>} The updated merge request
  */
 async function updateMergeRequest(projectId, options, mergeRequestIid, branchName) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     if (!mergeRequestIid && !branchName) {
         throw new Error("Either mergeRequestIid or branchName must be provided");
     }
@@ -1038,6 +1103,7 @@ async function updateMergeRequest(projectId, options, mergeRequestIid, branchNam
  */
 async function createNote(projectId, noteableType, // 'issue' 또는 'merge_request' 타입 명시
 noteableIid, body) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     // ⚙️ 응답 타입은 GitLab API 문서에 따라 조정 가능
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/${noteableType}s/${noteableIid}/notes` // Using plural form (issues/merge_requests) as per GitLab API documentation
     );
@@ -1052,6 +1118,43 @@ noteableIid, body) {
     }
     return await response.json();
 }
+/**
+ * Create a new thread on a merge request
+ * 📦 새로운 함수: createMergeRequestThread - 병합 요청에 새로운 스레드(토론)를 생성하는 함수
+ * (New function: createMergeRequestThread - Function to create a new thread (discussion) on a merge request)
+ *
+ * This function provides more capabilities than createNote, including the ability to:
+ * - Create diff notes (comments on specific lines of code)
+ * - Specify exact positions for comments
+ * - Set creation timestamps
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} mergeRequestIid - The internal ID of the merge request
+ * @param {string} body - The content of the thread
+ * @param {MergeRequestThreadPosition} [position] - Position information for diff notes
+ * @param {string} [createdAt] - ISO 8601 formatted creation date
+ * @returns {Promise<GitLabDiscussion>} The created discussion thread
+ */
+async function createMergeRequestThread(projectId, mergeRequestIid, body, position, createdAt) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/discussions`);
+    const payload = { body };
+    // Add optional parameters if provided
+    if (position) {
+        payload.position = position;
+    }
+    if (createdAt) {
+        payload.created_at = createdAt;
+    }
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+        method: "POST",
+        body: JSON.stringify(payload),
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabDiscussionSchema.parse(data);
+}
 /**
  * List all namespaces
  * 사용 가능한 모든 네임스페이스 목록 조회
@@ -1128,6 +1231,7 @@ async function verifyNamespaceExistence(namespacePath, parentId) {
  * @returns {Promise<GitLabProject>} Project details
  */
 async function getProject(projectId, options = {}) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}`);
     if (options.license) {
         url.searchParams.append("license", "true");
@@ -1183,6 +1287,7 @@ async function listProjects(options = {}) {
  * @returns Array of GitLab labels
  */
 async function listLabels(projectId, options = {}) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     // Construct the URL with project path
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/labels`);
     // Add query parameters
@@ -1215,6 +1320,7 @@ async function listLabels(projectId, options = {}) {
  * @returns GitLab label
  */
 async function getLabel(projectId, labelId, includeAncestorGroups) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/labels/${encodeURIComponent(String(labelId))}`);
     // Add query parameters
     if (includeAncestorGroups !== undefined) {
@@ -1238,6 +1344,7 @@ async function getLabel(projectId, labelId, includeAncestorGroups) {
  * @returns Created GitLab label
  */
 async function createLabel(projectId, options) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     // Make the API request
     const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/labels`, {
         ...DEFAULT_FETCH_CONFIG,
@@ -1259,6 +1366,7 @@ async function createLabel(projectId, options) {
  * @returns Updated GitLab label
  */
 async function updateLabel(projectId, labelId, options) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     // Make the API request
     const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/labels/${encodeURIComponent(String(labelId))}`, {
         ...DEFAULT_FETCH_CONFIG,
@@ -1278,6 +1386,7 @@ async function updateLabel(projectId, labelId, options) {
  * @param labelId The ID or name of the label to delete
  */
 async function deleteLabel(projectId, labelId) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     // Make the API request
     const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/labels/${encodeURIComponent(String(labelId))}`, {
         ...DEFAULT_FETCH_CONFIG,
@@ -1339,6 +1448,7 @@ async function listGroupProjects(options) {
  * List wiki pages in a project
  */
 async function listWikiPages(projectId, options = {}) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis`);
     if (options.page)
         url.searchParams.append("page", options.page.toString());
@@ -1355,6 +1465,7 @@ async function listWikiPages(projectId, options = {}) {
  * Get a specific wiki page
  */
 async function getWikiPage(projectId, slug) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, { ...DEFAULT_FETCH_CONFIG });
     await handleGitLabError(response);
     const data = await response.json();
@@ -1364,6 +1475,7 @@ async function getWikiPage(projectId, slug) {
  * Create a new wiki page
  */
 async function createWikiPage(projectId, title, content, format) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const body = { title, content };
     if (format)
         body.format = format;
@@ -1380,6 +1492,7 @@ async function createWikiPage(projectId, title, content, format) {
  * Update an existing wiki page
  */
 async function updateWikiPage(projectId, slug, title, content, format) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const body = {};
     if (title)
         body.title = title;
@@ -1400,6 +1513,7 @@ async function updateWikiPage(projectId, slug, title, content, format) {
  * Delete a wiki page
  */
 async function deleteWikiPage(projectId, slug) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
     const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, {
         ...DEFAULT_FETCH_CONFIG,
         method: "DELETE",
@@ -1413,6 +1527,7 @@ async function deleteWikiPage(projectId, slug) {
  * @returns {Promise<GitLabTreeItem[]>}
  */
 async function getRepositoryTree(options) {
+    options.project_id = decodeURIComponent(options.project_id); // Decode project_id within options
     const queryParams = new URLSearchParams();
     if (options.path)
         queryParams.append("path", options.path);
@@ -1447,11 +1562,29 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         ? allTools.filter((tool) => readOnlyTools.includes(tool.name))
         : allTools;
     // Toggle wiki tools by USE_GITLAB_WIKI flag
-    const tools = USE_GITLAB_WIKI
+    let tools = USE_GITLAB_WIKI
         ? tools0
         : tools0.filter((tool) => !wikiToolNames.includes(tool.name));
+    // <<< START: Gemini 호환성을 위해 $schema 제거 >>>
+    tools = tools.map((tool) => {
+        // inputSchema가 존재하고 객체인지 확인
+        if (tool.inputSchema &&
+            typeof tool.inputSchema === "object" &&
+            tool.inputSchema !== null) {
+            // $schema 키가 존재하면 삭제
+            if ("$schema" in tool.inputSchema) {
+                // 불변성을 위해 새로운 객체 생성 (선택적이지만 권장)
+                const modifiedSchema = { ...tool.inputSchema };
+                delete modifiedSchema.$schema;
+                return { ...tool, inputSchema: modifiedSchema };
+            }
+        }
+        // 변경이 필요 없으면 그대로 반환
+        return tool;
+    });
+    // <<< END: Gemini 호환성을 위해 $schema 제거 >>>
     return {
-        tools,
+        tools, // $schema가 제거된 도구 목록 반환
     };
 });
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -1557,12 +1690,20 @@ 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
+                const note = await updateMergeRequestNote(args.project_id, args.merge_request_iid, args.discussion_id, args.note_id, args.body, // Now optional
+                args.resolved // Now one of body or resolved must be provided, not both
                 );
                 return {
                     content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
                 };
             }
+            case "create_merge_request_note": {
+                const args = CreateMergeRequestNoteSchema.parse(request.params.arguments);
+                const note = await createMergeRequestNote(args.project_id, args.merge_request_iid, args.discussion_id, args.body, args.created_at);
+                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, args.source_branch);
@@ -1681,6 +1822,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
                 };
             }
+            case "create_merge_request_thread": {
+                const args = CreateMergeRequestThreadSchema.parse(request.params.arguments);
+                const { project_id, merge_request_iid, body, position, created_at } = args;
+                const thread = await createMergeRequestThread(project_id, merge_request_iid, body, position, created_at);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(thread, null, 2) }],
+                };
+            }
             case "list_issues": {
                 const args = ListIssuesSchema.parse(request.params.arguments);
                 const { project_id, ...options } = args;

package/build/schemas.js

@@ -434,8 +434,19 @@ 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().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"
+});
+// Input schema for adding a note to an existing merge request discussion
+export const CreateMergeRequestNoteSchema = ProjectParamsSchema.extend({
+    merge_request_iid: z.number().describe("The IID of a merge request"),
+    discussion_id: z.string().describe("The ID of a thread"),
     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
+    created_at: z.string().optional().describe("Date the note was created at (ISO 8601 format)"),
 });
 // API Operation Parameter Schemas
 export const CreateOrUpdateFileSchema = ProjectParamsSchema.extend({
@@ -919,3 +930,25 @@ export const GitLabWikiPageSchema = z.object({
     created_at: z.string().optional(),
     updated_at: z.string().optional(),
 });
+// Merge Request Thread position schema - used for diff notes
+export const MergeRequestThreadPositionSchema = z.object({
+    base_sha: z.string().describe("Base commit SHA in the source branch"),
+    head_sha: z.string().describe("SHA referencing HEAD of the source branch"),
+    start_sha: z.string().describe("SHA referencing the start commit of the source branch"),
+    position_type: z.enum(["text", "image", "file"]).describe("Type of position reference"),
+    new_path: z.string().optional().describe("File path after change"),
+    old_path: z.string().optional().describe("File path before change"),
+    new_line: z.number().nullable().optional().describe("Line number after change"),
+    old_line: z.number().nullable().optional().describe("Line number before change"),
+    width: z.number().optional().describe("Width of the image (for image diffs)"),
+    height: z.number().optional().describe("Height of the image (for image diffs)"),
+    x: z.number().optional().describe("X coordinate on the image (for image diffs)"),
+    y: z.number().optional().describe("Y coordinate on the image (for image diffs)"),
+});
+// Schema for creating a new merge request thread
+export const CreateMergeRequestThreadSchema = ProjectParamsSchema.extend({
+    merge_request_iid: z.number().describe("The IID of a merge request"),
+    body: z.string().describe("The content of the thread"),
+    position: MergeRequestThreadPositionSchema.optional().describe("Position when creating a diff note"),
+    created_at: z.string().optional().describe("Date the thread was created at (ISO 8601 format)"),
+});

package/package.json

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