@zereight/mcp-gitlab 1.0.34 → 1.0.36

package/README.md

@@ -51,9 +51,9 @@ When using with the Claude App, you need to set up your API key and URLs directl
 7. `create_merge_request` - Create a new merge request in a GitLab project
 8. `fork_repository` - Fork a GitLab project to your account or specified namespace
 9. `create_branch` - Create a new branch in a GitLab project
-10. `get_merge_request` - Get details of a merge request
-11. `get_merge_request_diffs` - Get the changes/diffs of a merge request
-12. `update_merge_request` - Update a merge request
+10. `get_merge_request` - Get details of a merge request (Either mergeRequestIid or branchName must be provided)
+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
@@ -81,4 +81,5 @@ When using with the Claude App, you need to set up your API key and URLs directl
 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)
 <!-- TOOLS-END -->

package/build/index.js

@@ -373,6 +373,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 +399,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 +420,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 +439,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 +473,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 +504,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 +534,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 +553,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 +578,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 +595,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 +614,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 +635,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 +661,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 +678,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 +712,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,6 +735,7 @@ 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) {
@@ -746,6 +763,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 +831,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 +869,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 +968,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 +1001,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 +1031,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 +1061,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
     );
@@ -1128,6 +1152,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 +1208,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 +1241,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 +1265,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 +1287,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 +1307,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 +1369,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 +1386,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 +1396,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 +1413,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 +1434,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 +1448,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 +1483,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) => {

package/build/schemas.js

@@ -156,11 +156,23 @@ export const GitLabTreeItemSchema = z.object({
 export const GetRepositoryTreeSchema = z.object({
     project_id: z.string().describe("The ID or URL-encoded path of the project"),
     path: z.string().optional().describe("The path inside the repository"),
-    ref: z.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"),
-    pagination: z.string().optional().describe("Pagination method (keyset)")
+    ref: z
+        .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"),
+    pagination: z.string().optional().describe("Pagination method (keyset)"),
 });
 export const GitLabTreeSchema = z.object({
     id: z.string(), // Changed from sha to match GitLab API
@@ -777,9 +789,7 @@ export const ListLabelsSchema = z.object({
 });
 export const GetLabelSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    label_id: z
-        .union([z.number(), z.string()])
-        .describe("The ID or title of a project's label"),
+    label_id: z.string().describe("The ID or title of a project's label"),
     include_ancestor_groups: z
         .boolean()
         .optional()
@@ -800,9 +810,7 @@ export const CreateLabelSchema = z.object({
 });
 export const UpdateLabelSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    label_id: z
-        .union([z.number(), z.string()])
-        .describe("The ID or title of a project's label"),
+    label_id: z.string().describe("The ID or title of a project's label"),
     new_name: z.string().optional().describe("The new name of the label"),
     color: z
         .string()
@@ -820,9 +828,7 @@ export const UpdateLabelSchema = z.object({
 });
 export const DeleteLabelSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path"),
-    label_id: z
-        .union([z.number(), z.string()])
-        .describe("The ID or title of a project's label"),
+    label_id: z.string().describe("The ID or title of a project's label"),
 });
 // Group projects schema
 export const ListGroupProjectsSchema = z.object({

package/package.json

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