@zereight/mcp-gitlab 1.0.64 → 1.0.66

package/README.md

@@ -35,9 +35,39 @@ When using with the Claude App, you need to set up your API key and URLs directl
 }
 ```
 
+#### vscode .vscode/mcp.json
+
+```json
+{
+  "inputs": [
+    {
+      "type": "promptString",
+      "id": "gitlab-token",
+      "description": "Gitlab Token to read API",
+      "password": true
+    }
+  ],
+  "servers": {
+    "GitLab-MCP": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@zereight/mcp-gitlab"],
+      "env": {
+        "GITLAB_PERSONAL_ACCESS_TOKEN": "${input:gitlab-token}",
+        "GITLAB_API_URL": "your-fancy-gitlab-url",
+        "GITLAB_READ_ONLY_MODE": "true",
+        ...
+      }
+    }
+  }
+}
+```
+
 #### Docker
-- stdio
-```mcp.json
+
+- stdio mcp.json
+
+```json
 {
   "mcpServers": {
     "GitLab communication server": {
@@ -74,6 +104,7 @@ When using with the Claude App, you need to set up your API key and URLs directl
 ```
 
 - sse
+
 ```shell
 docker run -i --rm \
   -e GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token \
@@ -91,6 +122,7 @@ docker run -i --rm \
 {
   "mcpServers": {
     "GitLab communication server": {
+      "type": "sse",
       "url": "http://localhost:3333/sse"
     }
   }
@@ -107,15 +139,19 @@ $ sh scripts/image_push.sh docker_user_name
 
 - `GITLAB_PERSONAL_ACCESS_TOKEN`: Your GitLab personal access token.
 - `GITLAB_API_URL`: Your GitLab API URL. (Default: `https://gitlab.com/api/v4`)
+- `GITLAB_PROJECT_ID`: Default project ID. If set, Overwrite this value when making an API request.
 - `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.
 - `USE_PIPELINE`: When set to 'true', enables the pipeline-related tools (list_pipelines, get_pipeline, list_pipeline_jobs, get_pipeline_job, get_pipeline_job_output, create_pipeline, retry_pipeline, cancel_pipeline). By default, pipeline features are disabled.
 - `GITLAB_AUTH_COOKIE_PATH`: Path to an authentication cookie file for GitLab instances that require cookie-based authentication. When provided, the cookie will be included in all GitLab API requests.
 
+[![Star History Chart](https://api.star-history.com/svg?repos=zereight/gitlab-mcp&type=Date)](https://www.star-history.com/#zereight/gitlab-mcp&Date)
+
 ## 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
@@ -127,58 +163,59 @@ $ sh scripts/image_push.sh docker_user_name
 9. `create_branch` - Create a new branch in a GitLab project
 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. `get_branch_diffs` - Get the changes/diffs between two branches or commits in a GitLab project
-13. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)
-14. `create_note` - Create a new note (comment) to an issue or merge request
-15. `create_merge_request_thread` - Create a new thread on a merge request
-16. `mr_discussions` - List discussion items for a merge request
-17. `update_merge_request_note` - Modify an existing merge request thread note
-18. `create_merge_request_note` - Add a new note to an existing merge request thread
-19. `update_issue_note` - Modify an existing issue thread note
-20. `create_issue_note` - Add a new note to an existing issue thread
-21. `list_issues` - List issues in a GitLab project with filtering options
-22. `get_issue` - Get details of a specific issue in a GitLab project
-23. `update_issue` - Update an issue in a GitLab project
-24. `delete_issue` - Delete an issue from a GitLab project
-25. `list_issue_links` - List all issue links for a specific issue
-26. `list_issue_discussions` - List discussions for an issue in a GitLab project
-27. `get_issue_link` - Get a specific issue link
-28. `create_issue_link` - Create an issue link between two issues
-29. `delete_issue_link` - Delete an issue link
-30. `list_namespaces` - List all namespaces available to the current user
-31. `get_namespace` - Get details of a namespace by ID or path
-32. `verify_namespace` - Verify if a namespace path exists
-33. `get_project` - Get details of a specific project
-34. `list_projects` - List projects accessible by the current user
-35. `list_labels` - List labels for a project
-36. `get_label` - Get a single label from a project
-37. `create_label` - Create a new label in a project
-38. `update_label` - Update an existing label in a project
-39. `delete_label` - Delete a label from a project
-40. `list_group_projects` - List projects in a GitLab group with filtering options
-41. `list_wiki_pages` - List wiki pages in a GitLab project
-42. `get_wiki_page` - Get details of a specific wiki page
-43. `create_wiki_page` - Create a new wiki page in a GitLab project
-44. `update_wiki_page` - Update an existing wiki page in a GitLab project
-45. `delete_wiki_page` - Delete a wiki page from a GitLab project
-46. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
-47. `list_pipelines` - List pipelines in a GitLab project with filtering options
-48. `get_pipeline` - Get details of a specific pipeline in a GitLab project
-49. `list_pipeline_jobs` - List all jobs in a specific pipeline
-50. `get_pipeline_job` - Get details of a GitLab pipeline job number
-51. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job number
-52. `create_pipeline` - Create a new pipeline for a branch or tag
-53. `retry_pipeline` - Retry a failed or canceled pipeline
-54. `cancel_pipeline` - Cancel a running pipeline
-55. `list_merge_requests` - List merge requests in a GitLab project with filtering options
-56. `list_milestones` - List milestones in a GitLab project with filtering options
-57. `get_milestone` - Get details of a specific milestone
-58. `create_milestone` - Create a new milestone in a GitLab project
-59. `edit_milestone` - Edit an existing milestone in a GitLab project
-60. `delete_milestone` - Delete a milestone from a GitLab project
-61. `get_milestone_issue` - Get issues associated with a specific milestone
-62. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
-63. `promote_milestone` - Promote a milestone to the next stage
-64. `get_milestone_burndown_events` - Get burndown events for a specific milestone
-65. `get_users` - Get GitLab user details by usernames
+12. `list_merge_request_diffs` - List merge request diffs with pagination support (Either mergeRequestIid or branchName must be provided)
+13. `get_branch_diffs` - Get the changes/diffs between two branches or commits in a GitLab project
+14. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)
+15. `create_note` - Create a new note (comment) to an issue or merge request
+16. `create_merge_request_thread` - Create a new thread on a merge request
+17. `mr_discussions` - List discussion items for a merge request
+18. `update_merge_request_note` - Modify an existing merge request thread note
+19. `create_merge_request_note` - Add a new note to an existing merge request thread
+20. `update_issue_note` - Modify an existing issue thread note
+21. `create_issue_note` - Add a new note to an existing issue thread
+22. `list_issues` - List issues in a GitLab project with filtering options
+23. `get_issue` - Get details of a specific issue in a GitLab project
+24. `update_issue` - Update an issue in a GitLab project
+25. `delete_issue` - Delete an issue from a GitLab project
+26. `list_issue_links` - List all issue links for a specific issue
+27. `list_issue_discussions` - List discussions for an issue in a GitLab project
+28. `get_issue_link` - Get a specific issue link
+29. `create_issue_link` - Create an issue link between two issues
+30. `delete_issue_link` - Delete an issue link
+31. `list_namespaces` - List all namespaces available to the current user
+32. `get_namespace` - Get details of a namespace by ID or path
+33. `verify_namespace` - Verify if a namespace path exists
+34. `get_project` - Get details of a specific project
+35. `list_projects` - List projects accessible by the current user
+36. `list_labels` - List labels for a project
+37. `get_label` - Get a single label from a project
+38. `create_label` - Create a new label in a project
+39. `update_label` - Update an existing label in a project
+40. `delete_label` - Delete a label from a project
+41. `list_group_projects` - List projects in a GitLab group with filtering options
+42. `list_wiki_pages` - List wiki pages in a GitLab project
+43. `get_wiki_page` - Get details of a specific wiki page
+44. `create_wiki_page` - Create a new wiki page in a GitLab project
+45. `update_wiki_page` - Update an existing wiki page in a GitLab project
+46. `delete_wiki_page` - Delete a wiki page from a GitLab project
+47. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
+48. `list_pipelines` - List pipelines in a GitLab project with filtering options
+49. `get_pipeline` - Get details of a specific pipeline in a GitLab project
+50. `list_pipeline_jobs` - List all jobs in a specific pipeline
+51. `get_pipeline_job` - Get details of a GitLab pipeline job number
+52. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job number
+53. `create_pipeline` - Create a new pipeline for a branch or tag
+54. `retry_pipeline` - Retry a failed or canceled pipeline
+55. `cancel_pipeline` - Cancel a running pipeline
+56. `list_merge_requests` - List merge requests in a GitLab project with filtering options
+57. `list_milestones` - List milestones in a GitLab project with filtering options
+58. `get_milestone` - Get details of a specific milestone
+59. `create_milestone` - Create a new milestone in a GitLab project
+60. `edit_milestone` - Edit an existing milestone in a GitLab project
+61. `delete_milestone` - Delete a milestone from a GitLab project
+62. `get_milestone_issue` - Get issues associated with a specific milestone
+63. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
+64. `promote_milestone` - Promote a milestone to the next stage
+65. `get_milestone_burndown_events` - Get burndown events for a specific milestone
+66. `get_users` - Get GitLab user details by usernames
 <!-- TOOLS-END -->

package/build/index.js

@@ -27,7 +27,7 @@ GetPipelineJobOutputSchema, GitLabPipelineJobSchema,
 GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, PaginatedDiscussionsResponseSchema, UpdateMergeRequestNoteSchema, // Added
 CreateMergeRequestNoteSchema, // Added
-ListMergeRequestDiscussionsSchema, UpdateIssueNoteSchema, CreateIssueNoteSchema, ListMergeRequestsSchema, GitLabMilestonesSchema, ListProjectMilestonesSchema, GetProjectMilestoneSchema, CreateProjectMilestoneSchema, EditProjectMilestoneSchema, DeleteProjectMilestoneSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, PromoteProjectMilestoneSchema, GetMilestoneBurndownEventsSchema, GitLabCompareResultSchema, GetBranchDiffsSchema, } from "./schemas.js";
+ListMergeRequestDiscussionsSchema, UpdateIssueNoteSchema, CreateIssueNoteSchema, ListMergeRequestsSchema, GitLabMilestonesSchema, ListProjectMilestonesSchema, GetProjectMilestoneSchema, CreateProjectMilestoneSchema, EditProjectMilestoneSchema, DeleteProjectMilestoneSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, PromoteProjectMilestoneSchema, GetMilestoneBurndownEventsSchema, GitLabCompareResultSchema, GetBranchDiffsSchema, ListCommitsSchema, GetCommitSchema, GetCommitDiffSchema, ListMergeRequestDiffsSchema, } from "./schemas.js";
 /**
  * Read version from package.json
  */
@@ -242,6 +242,11 @@ const allTools = [
         description: "Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)",
         inputSchema: zodToJsonSchema(GetMergeRequestDiffsSchema),
     },
+    {
+        name: "list_merge_request_diffs",
+        description: "List merge request diffs with pagination support (Either mergeRequestIid or branchName must be provided)",
+        inputSchema: zodToJsonSchema(ListMergeRequestDiffsSchema),
+    },
     {
         name: "get_branch_diffs",
         description: "Get the changes/diffs between two branches or commits in a GitLab project",
@@ -512,6 +517,21 @@ const allTools = [
         description: "Get GitLab user details by usernames",
         inputSchema: zodToJsonSchema(GetUsersSchema),
     },
+    {
+        name: "list_commits",
+        description: "List repository commits with filtering options",
+        inputSchema: zodToJsonSchema(ListCommitsSchema),
+    },
+    {
+        name: "get_commit",
+        description: "Get details of a specific commit",
+        inputSchema: zodToJsonSchema(GetCommitSchema),
+    },
+    {
+        name: "get_commit_diff",
+        description: "Get changes/diffs of a specific commit",
+        inputSchema: zodToJsonSchema(GetCommitDiffSchema),
+    },
 ];
 // Define which tools are read-only
 const readOnlyTools = [
@@ -549,6 +569,9 @@ const readOnlyTools = [
     "list_wiki_pages",
     "get_wiki_page",
     "get_users",
+    "list_commits",
+    "get_commit",
+    "get_commit_diff",
 ];
 // Define which tools are related to wiki and can be toggled by USE_GITLAB_WIKI
 const wikiToolNames = [
@@ -603,6 +626,7 @@ function normalizeGitLabApiUrl(url) {
 }
 // Use the normalizeGitLabApiUrl function to handle various URL formats
 const GITLAB_API_URL = normalizeGitLabApiUrl(process.env.GITLAB_API_URL || "");
+const GITLAB_PROJECT_ID = process.env.GITLAB_PROJECT_ID;
 if (!GITLAB_PERSONAL_ACCESS_TOKEN) {
     console.error("GITLAB_PERSONAL_ACCESS_TOKEN environment variable is not set");
     process.exit(1);
@@ -629,6 +653,13 @@ async function handleGitLabError(response) {
         }
     }
 }
+/**
+ * @param {string} projectId - The project ID parameter passed to the function
+ * @returns {string} The project ID to use for the API call
+ */
+function getEffectiveProjectId(projectId) {
+    return GITLAB_PROJECT_ID || projectId;
+}
 /**
  * Create a fork of a GitLab project
  * 프로젝트 포크 생성 (Create a project fork)
@@ -639,7 +670,8 @@ async function handleGitLabError(response) {
  */
 async function forkProject(projectId, namespace) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/fork`);
+    const effectiveProjectId = getEffectiveProjectId(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}/fork`);
     if (namespace) {
         url.searchParams.append("namespace", namespace);
     }
@@ -665,7 +697,8 @@ async function forkProject(projectId, namespace) {
  */
 async function createBranch(projectId, options) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/repository/branches`);
+    const effectiveProjectId = getEffectiveProjectId(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}/repository/branches`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
@@ -686,7 +719,8 @@ async function createBranch(projectId, options) {
  */
 async function getDefaultBranchRef(projectId) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}`);
+    const effectiveProjectId = getEffectiveProjectId(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -705,12 +739,13 @@ async function getDefaultBranchRef(projectId) {
  */
 async function getFileContents(projectId, filePath, ref) {
     projectId = decodeURIComponent(projectId); // Decode project ID
+    const effectiveProjectId = getEffectiveProjectId(projectId);
     const encodedPath = encodeURIComponent(filePath);
     // ref가 없는 경우 default branch를 가져옴
     if (!ref) {
         ref = await getDefaultBranchRef(projectId);
     }
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/repository/files/${encodedPath}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}/repository/files/${encodedPath}`);
     url.searchParams.append("ref", ref);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -739,7 +774,8 @@ async function getFileContents(projectId, filePath, ref) {
  */
 async function createIssue(projectId, options) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues`);
+    const effectiveProjectId = getEffectiveProjectId(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}/issues`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
@@ -770,7 +806,8 @@ async function createIssue(projectId, options) {
  */
 async function listIssues(projectId, options = {}) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues`);
+    const effectiveProjectId = getEffectiveProjectId(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(effectiveProjectId)}/issues`);
     // Add all query parameters
     Object.entries(options).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -807,7 +844,7 @@ async function listIssues(projectId, options = {}) {
  */
 async function listMergeRequests(projectId, options = {}) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests`);
     // Add all query parameters
     Object.entries(options).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -837,7 +874,7 @@ async function listMergeRequests(projectId, options = {}) {
  */
 async function getIssue(projectId, issueIid) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -856,7 +893,7 @@ async function getIssue(projectId, issueIid) {
  */
 async function updateIssue(projectId, issueIid, options) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}`);
     // Convert labels array to comma-separated string if present
     const body = { ...options };
     if (body.labels && Array.isArray(body.labels)) {
@@ -881,7 +918,7 @@ async function updateIssue(projectId, issueIid, options) {
  */
 async function deleteIssue(projectId, issueIid) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "DELETE",
@@ -898,7 +935,7 @@ async function deleteIssue(projectId, issueIid) {
  */
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}/links`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -917,7 +954,7 @@ async function listIssueLinks(projectId, issueIid) {
  */
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}/links/${issueLinkId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -939,7 +976,7 @@ async function getIssueLink(projectId, issueIid, issueLinkId) {
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}/links`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
@@ -964,7 +1001,7 @@ async function createIssueLink(projectId, issueIid, targetProjectId, targetIssue
  */
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}/links/${issueLinkId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "DELETE",
@@ -981,7 +1018,7 @@ async function deleteIssueLink(projectId, issueIid, issueLinkId) {
  */
 async function createMergeRequest(projectId, options) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
@@ -1022,7 +1059,7 @@ async function createMergeRequest(projectId, options) {
  */
 async function listDiscussions(projectId, resourceType, resourceIid, options = {}) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/${resourceType}/${resourceIid}/discussions`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/${resourceType}/${resourceIid}/discussions`);
     // Add query parameters for pagination and sorting
     if (options.page) {
         url.searchParams.append("page", options.page.toString());
@@ -1094,7 +1131,7 @@ async function listIssueDiscussions(projectId, issueIid, options = {}) {
  */
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests/${mergeRequestIid}/discussions/${discussionId}/notes/${noteId}`);
     // Only one of body or resolved can be sent according to GitLab API
     const payload = {};
     if (body !== undefined) {
@@ -1123,7 +1160,7 @@ async function updateMergeRequestNote(projectId, mergeRequestIid, discussionId,
  */
 async function updateIssueNote(projectId, issueIid, discussionId, noteId, body) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/discussions/${discussionId}/notes/${noteId}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}/discussions/${discussionId}/notes/${noteId}`);
     const payload = { body };
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -1145,7 +1182,7 @@ async function updateIssueNote(projectId, issueIid, discussionId, noteId, body)
  */
 async function createIssueNote(projectId, issueIid, discussionId, body, createdAt) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/discussions/${discussionId}/notes`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/issues/${issueIid}/discussions/${discussionId}/notes`);
     const payload = { body };
     if (createdAt) {
         payload.created_at = createdAt;
@@ -1172,7 +1209,7 @@ async function createIssueNote(projectId, issueIid, discussionId, body, createdA
  */
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests/${mergeRequestIid}/discussions/${discussionId}/notes`);
     const payload = { body };
     if (createdAt) {
         payload.created_at = createdAt;
@@ -1201,7 +1238,7 @@ async function createMergeRequestNote(projectId, mergeRequestIid, discussionId,
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/files/${encodedPath}`);
     const body = {
         branch,
         content,
@@ -1268,7 +1305,7 @@ async function createOrUpdateFile(projectId, filePath, content, commitMessage, b
  */
 async function createTree(projectId, files, ref) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/repository/tree`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/tree`);
     if (ref) {
         url.searchParams.append("ref", ref);
     }
@@ -1306,7 +1343,7 @@ async function createTree(projectId, files, ref) {
  */
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/commits`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
@@ -1407,10 +1444,10 @@ 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}`);
+        url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests/${mergeRequestIid}`);
     }
     else if (branchName) {
-        url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests?source_branch=${encodeURIComponent(branchName)}`);
+        url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests?source_branch=${encodeURIComponent(branchName)}`);
     }
     else {
         throw new Error("Either mergeRequestIid or branchName must be provided");
@@ -1445,7 +1482,7 @@ async function getMergeRequestDiffs(projectId, mergeRequestIid, branchName, view
         const mergeRequest = await getMergeRequest(projectId, undefined, branchName);
         mergeRequestIid = mergeRequest.iid;
     }
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/changes`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests/${mergeRequestIid}/changes`);
     if (view) {
         url.searchParams.append("view", view);
     }
@@ -1456,6 +1493,41 @@ async function getMergeRequestDiffs(projectId, mergeRequestIid, branchName, view
     const data = (await response.json());
     return z.array(GitLabDiffSchema).parse(data.changes);
 }
+/**
+ * Get merge request changes with detailed information including commits, diff_refs, and more
+ * 마지막으로 추가된 상세한 MR 변경사항 조회 함수 (Detailed merge request changes retrieval function)
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {number} mergeRequestIid - The internal ID of the merge request (Either mergeRequestIid or branchName must be provided)
+ * @param {string} [branchName] - The name of the branch to search for merge request by branch name (Either mergeRequestIid or branchName must be provided)
+ * @param {boolean} [unidiff] - Return diff in unidiff format
+ * @returns {Promise<any>} The complete merge request changes response
+ */
+async function listMergeRequestDiffs(projectId, mergeRequestIid, branchName, page, perPage, unidiff) {
+    projectId = decodeURIComponent(projectId); // Decode project ID
+    if (!mergeRequestIid && !branchName) {
+        throw new Error("Either mergeRequestIid or branchName must be provided");
+    }
+    if (branchName && !mergeRequestIid) {
+        const mergeRequest = await getMergeRequest(projectId, undefined, branchName);
+        mergeRequestIid = mergeRequest.iid;
+    }
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests/${mergeRequestIid}/diffs`);
+    if (page) {
+        url.searchParams.append("page", page.toString());
+    }
+    if (perPage) {
+        url.searchParams.append("per_page", perPage.toString());
+    }
+    if (unidiff) {
+        url.searchParams.append("unidiff", "true");
+    }
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+    });
+    await handleGitLabError(response);
+    return await response.json(); // Return full response including commits, diff_refs, changes, etc.
+}
 /**
  * Get branch comparison diffs
  *
@@ -1467,7 +1539,7 @@ async function getMergeRequestDiffs(projectId, mergeRequestIid, branchName, view
  */
 async function getBranchDiffs(projectId, from, to, straight) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/repository/compare`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/compare`);
     url.searchParams.append("from", from);
     url.searchParams.append("to", to);
     if (straight !== undefined) {
@@ -1502,7 +1574,7 @@ async function updateMergeRequest(projectId, options, mergeRequestIid, branchNam
         const mergeRequest = await getMergeRequest(projectId, undefined, branchName);
         mergeRequestIid = mergeRequest.iid;
     }
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests/${mergeRequestIid}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "PUT",
@@ -1526,7 +1598,7 @@ async function createNote(projectId, noteableType, // 'issue' 또는 'merge_requ
 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
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/${noteableType}s/${noteableIid}/notes` // Using plural form (issues/merge_requests) as per GitLab API documentation
     );
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
@@ -1558,7 +1630,7 @@ noteableIid, body) {
  */
 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 url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests/${mergeRequestIid}/discussions`);
     const payload = { body };
     // Add optional parameters if provided
     if (position) {
@@ -1653,7 +1725,7 @@ async function verifyNamespaceExistence(namespacePath, parentId) {
  */
 async function getProject(projectId, options = {}) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}`);
     if (options.license) {
         url.searchParams.append("license", "true");
     }
@@ -1710,7 +1782,7 @@ async function listProjects(options = {}) {
 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`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/labels`);
     // Add query parameters
     Object.entries(options).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -1742,7 +1814,7 @@ async function listLabels(projectId, options = {}) {
  */
 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))}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/labels/${encodeURIComponent(String(labelId))}`);
     // Add query parameters
     if (includeAncestorGroups !== undefined) {
         url.searchParams.append("include_ancestor_groups", includeAncestorGroups ? "true" : "false");
@@ -1767,7 +1839,7 @@ async function getLabel(projectId, labelId, includeAncestorGroups) {
 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`, {
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/labels`, {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
         body: JSON.stringify(options),
@@ -1789,7 +1861,7 @@ async function createLabel(projectId, options) {
 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))}`, {
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/labels/${encodeURIComponent(String(labelId))}`, {
         ...DEFAULT_FETCH_CONFIG,
         method: "PUT",
         body: JSON.stringify(options),
@@ -1809,7 +1881,7 @@ async function updateLabel(projectId, labelId, options) {
 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))}`, {
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/labels/${encodeURIComponent(String(labelId))}`, {
         ...DEFAULT_FETCH_CONFIG,
         method: "DELETE",
     });
@@ -1870,7 +1942,7 @@ async function listGroupProjects(options) {
  */
 async function listWikiPages(projectId, options = {}) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/wikis`);
     if (options.page)
         url.searchParams.append("page", options.page.toString());
     if (options.per_page)
@@ -1889,7 +1961,7 @@ async function listWikiPages(projectId, options = {}) {
  */
 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 });
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/wikis/${encodeURIComponent(slug)}`, { ...DEFAULT_FETCH_CONFIG });
     await handleGitLabError(response);
     const data = await response.json();
     return GitLabWikiPageSchema.parse(data);
@@ -1902,7 +1974,7 @@ 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`, {
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/wikis`, {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
         body: JSON.stringify(body),
@@ -1923,7 +1995,7 @@ async function updateWikiPage(projectId, slug, title, content, format) {
         body.content = content;
     if (format)
         body.format = format;
-    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, {
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/wikis/${encodeURIComponent(slug)}`, {
         ...DEFAULT_FETCH_CONFIG,
         method: "PUT",
         body: JSON.stringify(body),
@@ -1937,7 +2009,7 @@ async function updateWikiPage(projectId, slug, title, content, format) {
  */
 async function deleteWikiPage(projectId, slug) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/wikis/${encodeURIComponent(slug)}`, {
+    const response = await fetch(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/wikis/${encodeURIComponent(slug)}`, {
         ...DEFAULT_FETCH_CONFIG,
         method: "DELETE",
     });
@@ -1952,7 +2024,7 @@ async function deleteWikiPage(projectId, slug) {
  */
 async function listPipelines(projectId, options = {}) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipelines`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/pipelines`);
     // Add all query parameters
     Object.entries(options).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -1975,7 +2047,7 @@ async function listPipelines(projectId, options = {}) {
  */
 async function getPipeline(projectId, pipelineId) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/pipelines/${pipelineId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -1996,7 +2068,7 @@ async function getPipeline(projectId, pipelineId) {
  */
 async function listPipelineJobs(projectId, pipelineId, options = {}) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/jobs`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/pipelines/${pipelineId}/jobs`);
     // Add all query parameters
     Object.entries(options).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -2020,7 +2092,7 @@ async function listPipelineJobs(projectId, pipelineId, options = {}) {
 }
 async function getPipelineJob(projectId, jobId) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/jobs/${jobId}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/jobs/${jobId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -2042,7 +2114,7 @@ async function getPipelineJob(projectId, jobId) {
  */
 async function getPipelineJobOutput(projectId, jobId, limit, offset) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/jobs/${jobId}/trace`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/jobs/${jobId}/trace`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         headers: {
@@ -2087,7 +2159,7 @@ async function getPipelineJobOutput(projectId, jobId, limit, offset) {
  */
 async function createPipeline(projectId, ref, variables) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipeline`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/pipeline`);
     const body = { ref };
     if (variables && variables.length > 0) {
         body.variables = variables.reduce((acc, { key, value }) => {
@@ -2113,7 +2185,7 @@ async function createPipeline(projectId, ref, variables) {
  */
 async function retryPipeline(projectId, pipelineId) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/retry`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/pipelines/${pipelineId}/retry`);
     const response = await fetch(url.toString(), {
         method: "POST",
         headers: DEFAULT_HEADERS,
@@ -2131,7 +2203,7 @@ async function retryPipeline(projectId, pipelineId) {
  */
 async function cancelPipeline(projectId, pipelineId) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/cancel`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/pipelines/${pipelineId}/cancel`);
     const response = await fetch(url.toString(), {
         method: "POST",
         headers: DEFAULT_HEADERS,
@@ -2190,7 +2262,7 @@ async function getRepositoryTree(options) {
  */
 async function listProjectMilestones(projectId, options) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones`);
     Object.entries(options).forEach(([key, value]) => {
         if (value !== undefined) {
             if (key === "iids" && Array.isArray(value) && value.length > 0) {
@@ -2218,7 +2290,7 @@ async function listProjectMilestones(projectId, options) {
  */
 async function getProjectMilestone(projectId, milestoneId) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones/${milestoneId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -2234,7 +2306,7 @@ async function getProjectMilestone(projectId, milestoneId) {
  */
 async function createProjectMilestone(projectId, options) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
@@ -2253,7 +2325,7 @@ async function createProjectMilestone(projectId, options) {
  */
 async function editProjectMilestone(projectId, milestoneId, options) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones/${milestoneId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "PUT",
@@ -2271,7 +2343,7 @@ async function editProjectMilestone(projectId, milestoneId, options) {
  */
 async function deleteProjectMilestone(projectId, milestoneId) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones/${milestoneId}`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "DELETE",
@@ -2286,7 +2358,7 @@ async function deleteProjectMilestone(projectId, milestoneId) {
  */
 async function getMilestoneIssues(projectId, milestoneId) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}/issues`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones/${milestoneId}/issues`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -2302,7 +2374,7 @@ async function getMilestoneIssues(projectId, milestoneId) {
  */
 async function getMilestoneMergeRequests(projectId, milestoneId) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}/merge_requests`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones/${milestoneId}/merge_requests`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -2318,7 +2390,7 @@ async function getMilestoneMergeRequests(projectId, milestoneId) {
  */
 async function promoteProjectMilestone(projectId, milestoneId) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}/promote`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones/${milestoneId}/promote`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
         method: "POST",
@@ -2335,7 +2407,7 @@ async function promoteProjectMilestone(projectId, milestoneId) {
  */
 async function getMilestoneBurndownEvents(projectId, milestoneId) {
     projectId = decodeURIComponent(projectId);
-    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/milestones/${milestoneId}/burndown_events`);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/milestones/${milestoneId}/burndown_events`);
     const response = await fetch(url.toString(), {
         ...DEFAULT_FETCH_CONFIG,
     });
@@ -2395,6 +2467,89 @@ async function getUsers(usernames) {
     }
     return GitLabUsersResponseSchema.parse(users);
 }
+/**
+ * List repository commits
+ * 저장소 커밋 목록 조회
+ *
+ * @param {string} projectId - Project ID or URL-encoded path
+ * @param {ListCommitsOptions} options - List commits options
+ * @returns {Promise<GitLabCommit[]>} List of commits
+ */
+async function listCommits(projectId, options = {}) {
+    projectId = decodeURIComponent(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/commits`);
+    // Add query parameters
+    if (options.ref_name)
+        url.searchParams.append("ref_name", options.ref_name);
+    if (options.since)
+        url.searchParams.append("since", options.since);
+    if (options.until)
+        url.searchParams.append("until", options.until);
+    if (options.path)
+        url.searchParams.append("path", options.path);
+    if (options.author)
+        url.searchParams.append("author", options.author);
+    if (options.all)
+        url.searchParams.append("all", options.all.toString());
+    if (options.with_stats)
+        url.searchParams.append("with_stats", options.with_stats.toString());
+    if (options.first_parent)
+        url.searchParams.append("first_parent", options.first_parent.toString());
+    if (options.order)
+        url.searchParams.append("order", options.order);
+    if (options.trailers)
+        url.searchParams.append("trailers", options.trailers.toString());
+    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 z.array(GitLabCommitSchema).parse(data);
+}
+/**
+ * Get a single commit
+ * 단일 커밋 정보 조회
+ *
+ * @param {string} projectId - Project ID or URL-encoded path
+ * @param {string} sha - The commit hash or name of a repository branch or tag
+ * @param {boolean} [stats] - Include commit stats
+ * @returns {Promise<GitLabCommit>} The commit details
+ */
+async function getCommit(projectId, sha, stats) {
+    projectId = decodeURIComponent(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/commits/${encodeURIComponent(sha)}`);
+    if (stats) {
+        url.searchParams.append("stats", "true");
+    }
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabCommitSchema.parse(data);
+}
+/**
+ * Get commit diff
+ * 커밋 변경사항 조회
+ *
+ * @param {string} projectId - Project ID or URL-encoded path
+ * @param {string} sha - The commit hash or name of a repository branch or tag
+ * @returns {Promise<GitLabMergeRequestDiff[]>} The commit diffs
+ */
+async function getCommitDiff(projectId, sha) {
+    projectId = decodeURIComponent(projectId);
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/repository/commits/${encodeURIComponent(sha)}/diff`);
+    const response = await fetch(url.toString(), {
+        ...DEFAULT_FETCH_CONFIG,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return z.array(GitLabDiffSchema).parse(data);
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     // Apply read-only filter first
     const tools0 = GITLAB_READ_ONLY_MODE
@@ -2591,6 +2746,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(diffs, null, 2) }],
                 };
             }
+            case "list_merge_request_diffs": {
+                const args = ListMergeRequestDiffsSchema.parse(request.params.arguments);
+                const changes = await listMergeRequestDiffs(args.project_id, args.merge_request_iid, args.source_branch, args.page, args.per_page, args.unidiff);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(changes, null, 2) }],
+                };
+            }
             case "update_merge_request": {
                 const args = UpdateMergeRequestSchema.parse(request.params.arguments);
                 const { project_id, merge_request_iid, source_branch, ...options } = args;
@@ -3088,6 +3250,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "list_commits": {
+                const args = ListCommitsSchema.parse(request.params.arguments);
+                const commits = await listCommits(args.project_id, args);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(commits, null, 2) }],
+                };
+            }
+            case "get_commit": {
+                const args = GetCommitSchema.parse(request.params.arguments);
+                const commit = await getCommit(args.project_id, args.sha, args.stats);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(commit, null, 2) }],
+                };
+            }
+            case "get_commit_diff": {
+                const args = GetCommitDiffSchema.parse(request.params.arguments);
+                const diff = await getCommitDiff(args.project_id, args.sha);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(diff, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${request.params.name}`);
         }
@@ -3136,6 +3319,12 @@ async function runServer() {
                     res.status(400).send("No transport found for sessionId");
                 }
             });
+            app.get("/health", (_, res) => {
+                res.status(200).json({
+                    status: "healthy",
+                    version: process.env.npm_package_version || "unknown",
+                });
+            });
             const PORT = process.env.PORT || 3002;
             app.listen(PORT, () => {
                 console.log(`Server is running on port ${PORT}`);

package/build/schemas.js

@@ -374,8 +374,17 @@ export const GitLabCommitSchema = z.object({
     committer_name: z.string(),
     committer_email: z.string(),
     committed_date: z.string(),
+    created_at: z.string().optional(), // Add created_at field
+    message: z.string().optional(), // Add full message field
     web_url: z.string(), // Changed from html_url to match GitLab API
     parent_ids: z.array(z.string()), // Changed from parents to match GitLab API
+    stats: z.object({
+        additions: z.number().optional().nullable(),
+        deletions: z.number().optional().nullable(),
+        total: z.number().optional().nullable(),
+    }).optional(), // Only present when with_stats=true
+    trailers: z.record(z.string()).optional().default({}), // Git trailers, may be empty object
+    extended_trailers: z.record(z.array(z.string())).optional().default({}), // Extended trailers, may be empty object
 });
 // Reference schema
 export const GitLabReferenceSchema = z.object({
@@ -596,6 +605,20 @@ export const GitLabMergeRequestSchema = z.object({
     squash: z.boolean().optional(),
     labels: z.array(z.string()).optional(),
 });
+export const LineRangeSchema = z.object({
+    start: z.object({
+        line_code: z.string().nullable().optional().describe("CRITICAL: Line identifier in format '{file_path_sha1_hash}_{old_line_number}_{new_line_number}'. USUALLY REQUIRED for GitLab diff comments despite being optional in schema. Example: 'a1b2c3d4e5f6_10_15'. Get this from GitLab diff API response, never fabricate."),
+        type: z.enum(["new", "old", "expanded"]).nullable().optional().describe("Line type: 'old' = deleted/original line, 'new' = added/modified line, null = unchanged context. MUST match the line_code format and old_line/new_line values."),
+        old_line: z.number().nullable().optional().describe("Line number in original file (before changes). REQUIRED when type='old', NULL when type='new' (for purely added lines), can be present for context lines."),
+        new_line: z.number().nullable().optional().describe("Line number in modified file (after changes). REQUIRED when type='new', NULL when type='old' (for purely deleted lines), can be present for context lines."),
+    }).describe("Start line position for multiline comment range. MUST specify either old_line OR new_line (or both for context), never neither."),
+    end: z.object({
+        line_code: z.string().nullable().optional().describe("CRITICAL: Line identifier in format '{file_path_sha1_hash}_{old_line_number}_{new_line_number}'. USUALLY REQUIRED for GitLab diff comments despite being optional in schema. Example: 'a1b2c3d4e5f6_12_17'. Must be from same file as start.line_code."),
+        type: z.enum(["new", "old", "expanded"]).nullable().optional().describe("Line type: 'old' = deleted/original line, 'new' = added/modified line, null = unchanged context. SHOULD MATCH start.type for consistent ranges (don't mix old/new types)."),
+        old_line: z.number().nullable().optional().describe("Line number in original file (before changes). REQUIRED when type='old', NULL when type='new' (for purely added lines), can be present for context lines. MUST be >= start.old_line if both specified."),
+        new_line: z.number().nullable().optional().describe("Line number in modified file (after changes). REQUIRED when type='new', NULL when type='old' (for purely deleted lines), can be present for context lines. MUST be >= start.new_line if both specified."),
+    }).describe("End line position for multiline comment range. MUST specify either old_line OR new_line (or both for context), never neither. Range must be valid (end >= start)."),
+}).describe("Line range for multiline comments on GitLab merge request diffs. VALIDATION RULES: 1) line_code is critical for GitLab API success, 2) start/end must have consistent types, 3) line numbers must form valid range, 4) get line_code from GitLab diff API, never generate manually.");
 // Discussion related schemas
 export const GitLabDiscussionNoteSchema = z.object({
     id: z.number(),
@@ -620,28 +643,12 @@ export const GitLabDiscussionNoteSchema = z.object({
         base_sha: z.string(),
         start_sha: z.string(),
         head_sha: z.string(),
-        old_path: z.string(),
-        new_path: z.string(),
+        old_path: z.string().nullable().optional().describe("File path before change"),
+        new_path: z.string().nullable().optional().describe("File path after change"),
         position_type: z.enum(["text", "image", "file"]),
-        old_line: z.number().nullish(), // This is missing for image diffs
-        new_line: z.number().nullish(), // This is missing for image diffs
-        line_range: z
-            .object({
-            start: z.object({
-                line_code: z.string(),
-                type: z.enum(["new", "old", "expanded"]),
-                old_line: z.number().nullish(), // This is missing for image diffs
-                new_line: z.number().nullish(), // This is missing for image diffs
-            }),
-            end: z.object({
-                line_code: z.string(),
-                type: z.enum(["new", "old", "expanded"]),
-                old_line: z.number().nullish(), // This is missing for image diffs
-                new_line: z.number().nullish(), // This is missing for image diffs
-            }),
-        })
-            .nullable()
-            .optional(), // For multi-line diff notes
+        new_line: z.number().nullable().optional().describe("Line number in the modified file (after changes). Used for added lines and context lines. Null for deleted lines."),
+        old_line: z.number().nullable().optional().describe("Line number in the original file (before changes). Used for deleted lines and context lines. Null for newly added lines."),
+        line_range: LineRangeSchema.nullable().optional(), // For multi-line diff notes
         width: z.number().optional(), // For image diff notes
         height: z.number().optional(), // For image diff notes
         x: z.number().optional(), // For image diff notes
@@ -818,6 +825,11 @@ export const UpdateMergeRequestSchema = GetMergeRequestSchema.extend({
 export const GetMergeRequestDiffsSchema = GetMergeRequestSchema.extend({
     view: z.enum(["inline", "parallel"]).optional().describe("Diff view type"),
 });
+export const ListMergeRequestDiffsSchema = GetMergeRequestSchema.extend({
+    page: z.number().optional().describe("Page number for pagination (default: 1)"),
+    per_page: z.number().optional().describe("Number of items per page (max: 100, default: 20)"),
+    unidiff: z.boolean().optional().describe("Present diffs in the unified diff format. Default is false. Introduced in GitLab 16.5."),
+});
 export const CreateNoteSchema = z.object({
     project_id: z.string().describe("Project ID or namespace/project_path"),
     noteable_type: z
@@ -1124,18 +1136,19 @@ export const GitLabWikiPageSchema = z.object({
 });
 // 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)"),
+    base_sha: z.string().describe("REQUIRED: Base commit SHA in the source branch. Get this from merge request diff_refs.base_sha."),
+    head_sha: z.string().describe("REQUIRED: SHA referencing HEAD of the source branch. Get this from merge request diff_refs.head_sha."),
+    start_sha: z.string().describe("REQUIRED: SHA referencing the start commit of the source branch. Get this from merge request diff_refs.start_sha."),
+    position_type: z.enum(["text", "image", "file"]).describe("REQUIRED: Position type. Use 'text' for code diffs, 'image' for image diffs, 'file' for file-level comments."),
+    new_path: z.string().nullable().optional().describe("File path after changes. REQUIRED for most diff comments. Use same as old_path if file wasn't renamed."),
+    old_path: z.string().nullable().optional().describe("File path before changes. REQUIRED for most diff comments. Use same as new_path if file wasn't renamed."),
+    new_line: z.number().nullable().optional().describe("Line number in modified file (after changes). Use for added lines or context lines. NULL for deleted lines. For single-line comments on new lines."),
+    old_line: z.number().nullable().optional().describe("Line number in original file (before changes). Use for deleted lines or context lines. NULL for added lines. For single-line comments on old lines."),
+    line_range: LineRangeSchema.optional().describe("MULTILINE COMMENTS: Specify start/end line positions for commenting on multiple lines. Alternative to single old_line/new_line."),
+    width: z.number().optional().describe("IMAGE DIFFS ONLY: Width of the image (for position_type='image')."),
+    height: z.number().optional().describe("IMAGE DIFFS ONLY: Height of the image (for position_type='image')."),
+    x: z.number().optional().describe("IMAGE DIFFS ONLY: X coordinate on the image (for position_type='image')."),
+    y: z.number().optional().describe("IMAGE DIFFS ONLY: Y coordinate on the image (for position_type='image')."),
 });
 // Schema for creating a new merge request thread
 export const CreateMergeRequestThreadSchema = ProjectParamsSchema.extend({
@@ -1202,3 +1215,28 @@ export const GetMilestoneMergeRequestsSchema = GetProjectMilestoneSchema.merge(P
 export const PromoteProjectMilestoneSchema = GetProjectMilestoneSchema;
 // Schema for getting burndown chart events for a milestone
 export const GetMilestoneBurndownEventsSchema = GetProjectMilestoneSchema.merge(PaginationOptionsSchema);
+// Add schemas for commit operations
+export const ListCommitsSchema = z.object({
+    project_id: z.string().describe("Project ID or complete URL-encoded path to project"),
+    ref_name: z.string().optional().describe("The name of a repository branch, tag or revision range, or if not given the default branch"),
+    since: z.string().optional().describe("Only commits after or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ"),
+    until: z.string().optional().describe("Only commits before or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ"),
+    path: z.string().optional().describe("The file path"),
+    author: z.string().optional().describe("Search commits by commit author"),
+    all: z.boolean().optional().describe("Retrieve every commit from the repository"),
+    with_stats: z.boolean().optional().describe("Stats about each commit are added to the response"),
+    first_parent: z.boolean().optional().describe("Follow only the first parent commit upon seeing a merge commit"),
+    order: z.enum(["default", "topo"]).optional().describe("List commits in order"),
+    trailers: z.boolean().optional().describe("Parse and include Git trailers for every commit"),
+    page: z.number().optional().describe("Page number for pagination (default: 1)"),
+    per_page: z.number().optional().describe("Number of items per page (max: 100, default: 20)"),
+});
+export const GetCommitSchema = z.object({
+    project_id: z.string().describe("Project ID or complete URL-encoded path to project"),
+    sha: z.string().describe("The commit hash or name of a repository branch or tag"),
+    stats: z.boolean().optional().describe("Include commit stats"),
+});
+export const GetCommitDiffSchema = z.object({
+    project_id: z.string().describe("Project ID or complete URL-encoded path to project"),
+    sha: z.string().describe("The commit hash or name of a repository branch or tag"),
+});

package/package.json

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