@zereight/mcp-gitlab 2.1.40 → 2.1.42

package/README.ko.md

@@ -80,7 +80,7 @@ npm install -g @zereight/mcp-gitlab
 
 예시는 기존 `mcp-gitlab`보다 충돌 가능성이 낮은 `zereight-mcp-gitlab` 별칭을 사용합니다. MCP 클라이언트가 찾지 못하면 `which zereight-mcp-gitlab`의 절대 경로를 사용하세요.
 
-전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.1.38`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
+전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.1.41`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
 
 #### CLI 인자 사용하기(환경 변수 문제가 있는 클라이언트용)
 

package/README.md

@@ -80,7 +80,7 @@ npm install -g @zereight/mcp-gitlab
 
 The examples use `zereight-mcp-gitlab`, a less collision-prone alias for the legacy `mcp-gitlab` binary. If your MCP client cannot find it, use the absolute path from `which zereight-mcp-gitlab`.
 
-No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.1.38`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
+No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.1.41`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
 
 #### Using CLI Arguments (for clients with env var issues)
 
@@ -541,183 +541,217 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
 <!-- TOOLS-START -->
 
 1. `merge_merge_request` - Merge a merge request in a GitLab project
-2. `create_or_update_file` - Create or update a single file in a GitLab project
-3. `search_repositories` - Search for GitLab projects
-4. `create_repository` - Create a new GitLab project
-5. `create_group` - Create a new GitLab group or subgroup (name, path, description, visibility, and optional parent_id)
-6. `get_file_contents` - Get the contents of a file or directory from a GitLab project
-7. `push_files` - Push multiple files to a GitLab project in a single commit
-8. `create_issue` - Create a new issue in a GitLab project
-9. `create_merge_request` - Create a new merge request in a GitLab project
-10. `fork_repository` - Fork a GitLab project to your account or specified namespace
-11. `create_branch` - Create a new branch in a GitLab project
-12. `get_merge_request` - Get details of a merge request with compact deployment summary, behind-count, commit addition summary, and approval summary (Either mergeRequestIid or branchName must be provided)
-13. `get_merge_request_diffs` - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)
-14. `list_merge_request_diffs` - List merge request diffs with pagination support (Either mergeRequestIid or branchName must be provided)
-15. `get_merge_request_conflicts` - Get the conflicts of a merge request in a GitLab project
-16. `list_merge_request_changed_files` - STEP 1 of code review workflow. Returns ONLY the list of changed file paths in a merge request — WITHOUT diff content. Call this first to get file paths, then call get_merge_request_file_diff with multiple files in a single batched call (recommended 3-5 files per call). Supports excluded_file_patterns filtering using regex. (Either mergeRequestIid or branchName must be provided)
-17. `get_merge_request_file_diff` - STEP 2 of code review workflow. Get diffs for one or more files from a merge request. Call list_merge_request_changed_files first, then pass them as an array to fetch diffs efficiently. Batching multiple files (recommended 3-5) is supported. (Either mergeRequestIid or branchName must be provided)
-18. `list_merge_request_versions` - List all versions of a merge request
-19. `get_merge_request_version` - Get a specific version of a merge request
-20. `get_branch_diffs` - Get the changes/diffs between two branches or commits in a GitLab project
-21. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)
-22. `create_note` - Create a new note (comment) to an issue or merge request
-23. `create_merge_request_thread` - Create a new thread on a merge request
-24. `mr_discussions` - List discussion items for a merge request
-25. `resolve_merge_request_thread` - Resolve a thread on a merge request
-26. `update_merge_request_note` - Modify an existing merge request thread note
-27. `create_merge_request_note` - Add a new note to an existing merge request thread
-28. `delete_merge_request_discussion_note` - Delete a discussion note on a merge request
-29. `update_merge_request_discussion_note` - Update a discussion note on a merge request
-30. `create_merge_request_discussion_note` - Add a new discussion note to an existing merge request thread
-31. `delete_merge_request_note` - Delete an existing merge request note
-32. `get_merge_request_note` - Get a specific note for a merge request
-33. `get_merge_request_notes` - List notes for a merge request
-34. `get_draft_note` - Get a single draft note from a merge request
-35. `list_draft_notes` - List draft notes for a merge request
-36. `create_draft_note` - Create a draft note for a merge request
-37. `update_draft_note` - Update an existing draft note
-38. `delete_draft_note` - Delete a draft note
-39. `publish_draft_note` - Publish a single draft note
-40. `bulk_publish_draft_notes` - Publish all draft notes for a merge request
-41. `list_merge_requests` - List merge requests globally or in a specific GitLab project with filtering options (project_id is now optional)
-42. `approve_merge_request` - Approve a merge request (requires appropriate permissions)
-43. `unapprove_merge_request` - Unapprove a previously approved merge request
-44. `get_merge_request_approval_state` - Get merge request approval details including approvers (uses `approval_state` when available, otherwise falls back to `approvals`)
-45. `update_issue_note` - Modify an existing issue thread note
-46. `create_issue_note` - Add a new note to an existing issue thread
-47. `list_issues` - List issues (default: created by current user only; use scope='all' for all accessible issues)
-48. `my_issues` - List issues assigned to the authenticated user (defaults to open issues)
-49. `get_issue` - Get details of a specific issue in a GitLab project
-50. `update_issue` - Update an issue in a GitLab project
-51. `update_issue_description_patch` - Apply a patch (search/replace or unified diff) to an issue description. Reduces token usage by sending only the change instead of the full description. Supports `dry_run` to preview and `create_note` to summarize.
-52. `delete_issue` - Delete an issue from a GitLab project
-53. `list_todos` - List GitLab to-do items for the current user
-54. `mark_todo_done` - Mark a GitLab to-do item as done
-55. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
-56. `list_issue_links` - List all issue links for a specific issue
-57. `list_issue_discussions` - List discussions for an issue in a GitLab project
-58. `get_issue_link` - Get a specific issue link
-59. `create_issue_link` - Create an issue link between two issues
-60. `delete_issue_link` - Delete an issue link
-61. `list_namespaces` - List all namespaces available to the current user
-62. `get_namespace` - Get details of a namespace by ID or path
-63. `verify_namespace` - Verify if a namespace path exists
-64. `get_project` - Get details of a specific project
-65. `list_projects` - List projects accessible by the current user
-66. `list_project_members` - List members of a GitLab project
-67. `list_group_projects` - List projects in a GitLab group with filtering options
-68. `list_group_iterations` - List group iterations with filtering options
-69. `list_labels` - List labels for a project
-70. `get_label` - Get a single label from a project
-71. `create_label` - Create a new label in a project
-72. `update_label` - Update an existing label in a project
-73. `delete_label` - Delete a label from a project
-74. `list_pipelines` - List pipelines in a GitLab project with filtering options
-75. `get_pipeline` - Get details of a specific pipeline in a GitLab project
-76. `list_pipeline_jobs` - List all jobs in a specific pipeline
-77. `list_pipeline_trigger_jobs` - List all trigger jobs (bridges) in a specific pipeline that trigger downstream pipelines
-78. `get_pipeline_job` - Get details of a GitLab pipeline job number
-79. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job with optional pagination to limit context window usage
-80. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
-81. `validate_project_ci_lint` - Validate an existing `.gitlab-ci.yml` configuration for a project
-82. `create_pipeline` - Create a new pipeline for a branch or tag
-83. `retry_pipeline` - Retry a failed or canceled pipeline
-84. `cancel_pipeline` - Cancel a running pipeline
-85. `play_pipeline_job` - Run a manual pipeline job
-86. `retry_pipeline_job` - Retry a failed or canceled pipeline job
-87. `cancel_pipeline_job` - Cancel a running pipeline job
-88. `list_deployments` - List deployments in a GitLab project with filtering options
-89. `get_deployment` - Get details of a specific deployment in a GitLab project
-90. `list_environments` - List environments in a GitLab project
-91. `get_environment` - Get details of a specific environment in a GitLab project
-92. `list_job_artifacts` - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes
-93. `download_job_artifacts` - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path
-94. `get_job_artifact_file` - Get the content of a single file from a job's artifacts by its path within the archive
-95. `list_milestones` - List milestones in a GitLab project with filtering options
-96. `get_milestone` - Get details of a specific milestone
-97. `create_milestone` - Create a new milestone in a GitLab project
-98. `edit_milestone` - Edit an existing milestone in a GitLab project
-99. `delete_milestone` - Delete a milestone from a GitLab project
-100. `get_milestone_issue` - Get issues associated with a specific milestone
-101. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
-102. `promote_milestone` - Promote a milestone to the next stage
-103. `get_milestone_burndown_events` - Get burndown events for a specific milestone
-104. `list_group_milestones` - List milestones in a GitLab group with filtering options
-105. `get_group_milestone` - Get details of a specific group milestone
-106. `create_group_milestone` - Create a new milestone in a GitLab group
-107. `edit_group_milestone` - Edit an existing group milestone
-108. `delete_group_milestone` - Delete a milestone from a GitLab group
-109. `get_group_milestone_issue` - Get issues associated with a specific group milestone
-110. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
-111. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
-112. `list_wiki_pages` - List wiki pages in a GitLab project
-113. `get_wiki_page` - Get details of a specific wiki page
-114. `create_wiki_page` - Create a new wiki page in a GitLab project
-115. `update_wiki_page` - Update an existing wiki page in a GitLab project
-116. `delete_wiki_page` - Delete a wiki page from a GitLab project
-117. `list_group_wiki_pages` - List wiki pages in a GitLab group
-118. `get_group_wiki_page` - Get details of a specific group wiki page
-119. `create_group_wiki_page` - Create a new wiki page in a GitLab group
-120. `update_group_wiki_page` - Update an existing wiki page in a GitLab group
-121. `delete_group_wiki_page` - Delete a wiki page from a GitLab group
-122. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
-123. `list_commits` - List repository commits with filtering options
-124. `get_commit` - Get details of a specific commit
-125. `get_commit_diff` - Get changes/diffs of a specific commit
-126. `list_commit_statuses` - List statuses for a specific commit
-127. `create_commit_status` - Create or update the status of a specific commit
-128. `list_releases` - List all releases for a project
-129. `get_release` - Get a release by tag name
-130. `create_release` - Create a new release in a GitLab project
-131. `update_release` - Update an existing release in a GitLab project
-132. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
-133. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
-134. `download_release_asset` - Download a release asset file by direct asset path
-135. `list_tags` - List repository tags with filtering and pagination support
-136. `get_tag` - Get details of a specific repository tag
-137. `create_tag` - Create a new tag in the repository
-138. `delete_tag` - Delete a tag from the repository
-139. `get_tag_signature` - Get the signature of a signed tag
-140. `get_users` - Get GitLab user details by usernames
-141. `list_events` - List all events for the currently authenticated user
-142. `get_project_events` - List all visible events for a specified project
-143. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
-144. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
-145. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
-146. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
-147. `create_work_item` - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality
-148. `update_work_item` - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields
-149. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
-150. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
-151. `list_custom_field_definitions` - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item
-152. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
-153. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
-154. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
-155. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
-156. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
-157. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
-158. `list_webhook_events` - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details
-159. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
-160. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
-161. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
-162. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
-163. `execute_graphql` - Execute a GitLab GraphQL query
-164. `list_merge_request_pipelines` - List pipelines for a merge request with pagination support
-165. `list_project_variables` - List CI/CD variables for a project with optional environment scope filter
-166. `get_project_variable` - Get a single CI/CD variable from a project by key, with optional environment scope filter
-167. `create_project_variable` - Create a new CI/CD variable in a project
-168. `update_project_variable` - Update an existing CI/CD variable in a project, with optional filter to disambiguate by environment scope
-169. `delete_project_variable` - Delete a CI/CD variable from a project, with optional filter to disambiguate by environment scope
-170. `list_group_variables` - List CI/CD variables for a group with optional environment scope filter
-171. `get_group_variable` - Get a single CI/CD variable from a group by key, with optional environment scope filter
-172. `create_group_variable` - Create a new CI/CD variable in a group
-173. `update_group_variable` - Update an existing CI/CD variable in a group, with optional filter to disambiguate by environment scope
-174. `delete_group_variable` - Delete a CI/CD variable from a group, with optional filter to disambiguate by environment scope
-175. `get_dependency_proxy_settings` - Get dependency proxy settings for a group (enabled status, blob count, total size, image prefix, TTL policy)
-176. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
-177. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group with cursor-based pagination
-178. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
+2. `approve_merge_request` - Approve a merge request (requires appropriate permissions)
+3. `unapprove_merge_request` - Unapprove a previously approved merge request
+4. `get_merge_request_approval_state` - Get merge request approval details including approvers (uses `approval_state` when available, otherwise falls back to `approvals`)
+5. `get_merge_request_conflicts` - Get the conflicts of a merge request in a GitLab project
+6. `list_merge_request_pipelines` - List pipelines for a merge request with pagination support
+7. `execute_graphql` - Execute a GitLab GraphQL query
+8. `create_or_update_file` - Create or update a single file in a GitLab project
+9. `search_repositories` - Search for GitLab projects
+10. `create_repository` - Create a new GitLab project
+11. `create_group` - Create a new GitLab group or subgroup (name, path, description, visibility, and optional parent_id)
+12. `get_file_contents` - Get the contents of a file or directory from a GitLab project
+13. `push_files` - Push multiple files to a GitLab project in a single commit
+14. `create_issue` - Create a new issue in a GitLab project
+15. `create_merge_request` - Create a new merge request in a GitLab project
+16. `fork_repository` - Fork a GitLab project to your account or specified namespace
+17. `create_branch` - Create a new branch in a GitLab project
+18. `get_branch` - Get branch details (commit, protection status)
+19. `list_branches` - List branches in project with search filter
+20. `delete_branch` - Delete branch from project
+21. `list_protected_branches` - List protected branches in a project, supports search filter
+22. `get_protected_branch` - Get details of a single protected branch (access levels, force push settings)
+23. `protect_branch` - Protect a repository branch (set push/merge/unprotect access levels)
+24. `unprotect_branch` - Remove protection from a previously protected branch
+25. `update_default_branch` - Change the default branch of a project
+26. `get_merge_request` - Get details of a merge request with compact deployment summary, behind-count, commit addition summary, and approval summary (Either mergeRequestIid or branchName must be provided)
+27. `get_merge_request_diffs` - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)
+28. `list_merge_request_changed_files` - STEP 1 of code review workflow. Returns ONLY the list of changed file paths in a merge request — WITHOUT diff content. Call this first to get file paths, then call get_merge_request_file_diff with multiple files in a single batched call (recommended 3-5 files per call). Supports excluded_file_patterns filtering using regex. (Either mergeRequestIid or branchName must be provided)
+29. `list_merge_request_diffs` - List merge request diffs with pagination support (Either mergeRequestIid or branchName must be provided)
+30. `get_merge_request_file_diff` - STEP 2 of code review workflow. Get diffs for one or more files from a merge request. Call list_merge_request_changed_files first, then pass them as an array to fetch diffs efficiently. Batching multiple files (recommended 3-5) is supported. (Either mergeRequestIid or branchName must be provided)
+31. `list_merge_request_versions` - List all versions of a merge request
+32. `get_merge_request_version` - Get a specific version of a merge request
+33. `get_branch_diffs` - Get the changes/diffs between two branches or commits in a GitLab project
+34. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)
+35. `create_note` - Create a new note (comment) to an issue or merge request
+36. `create_merge_request_thread` - Create a new thread on a merge request
+37. `resolve_merge_request_thread` - Resolve a thread on a merge request
+38. `mr_discussions` - List discussion items for a merge request
+39. `delete_merge_request_discussion_note` - Delete a discussion note on a merge request
+40. `update_merge_request_discussion_note` - Update a discussion note on a merge request
+41. `create_merge_request_discussion_note` - Add a new discussion note to an existing merge request thread
+42. `create_merge_request_note` - Add a new note to an existing merge request thread
+43. `delete_merge_request_note` - Delete an existing merge request note
+44. `get_merge_request_note` - Get a specific note for a merge request
+45. `get_merge_request_notes` - List notes for a merge request
+46. `update_merge_request_note` - Modify an existing merge request thread note
+47. `get_draft_note` - Get a single draft note from a merge request
+48. `list_draft_notes` - List draft notes for a merge request
+49. `create_draft_note` - Create a draft note for a merge request
+50. `update_draft_note` - Update an existing draft note
+51. `delete_draft_note` - Delete a draft note
+52. `publish_draft_note` - Publish a single draft note
+53. `bulk_publish_draft_notes` - Publish all draft notes for a merge request
+54. `list_merge_request_emoji_reactions` - List all emoji reactions on a merge request
+55. `list_merge_request_note_emoji_reactions` - List all emoji reactions on a merge request note. Pass discussion_id for discussion thread replies.
+56. `create_merge_request_emoji_reaction` - Add an emoji reaction to a merge request (e.g. thumbsup, rocket, eyes)
+57. `delete_merge_request_emoji_reaction` - Remove an emoji reaction from a merge request
+58. `create_merge_request_note_emoji_reaction` - Add an emoji reaction to a merge request note. Pass discussion_id for discussion thread replies.
+59. `delete_merge_request_note_emoji_reaction` - Remove an emoji reaction from a merge request note. Pass discussion_id for discussion thread replies.
+60. `update_issue_note` - Modify an existing issue thread note
+61. `create_issue_note` - Add a new note to an existing issue thread
+62. `list_issue_emoji_reactions` - List all emoji reactions on an issue
+63. `list_issue_note_emoji_reactions` - List all emoji reactions on an issue note. Pass discussion_id for discussion thread replies.
+64. `create_issue_emoji_reaction` - Add an emoji reaction to an issue (e.g. thumbsup, rocket, eyes)
+65. `delete_issue_emoji_reaction` - Remove an emoji reaction from an issue
+66. `create_issue_note_emoji_reaction` - Add an emoji reaction to an issue note. Pass discussion_id for discussion thread replies.
+67. `delete_issue_note_emoji_reaction` - Remove an emoji reaction from an issue note. Pass discussion_id for discussion thread replies.
+68. `list_issues` - List issues (default: created by current user only; use scope='all' for all accessible issues)
+69. `my_issues` - List issues assigned to the authenticated user (defaults to open issues)
+70. `get_issue` - Get details of a specific issue in a GitLab project
+71. `update_issue` - Update an issue in a GitLab project
+72. `update_issue_description_patch` - Apply a patch (search/replace or unified diff) to an issue description. Reduces token usage by sending only the change instead of the full description. Supports `dry_run` to preview and `create_note` to summarize.
+73. `delete_issue` - Delete an issue from a GitLab project
+74. `list_todos` - List GitLab to-do items for the current user
+75. `mark_todo_done` - Mark a GitLab to-do item as done
+76. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
+77. `list_issue_links` - List all issue links for a specific issue
+78. `list_issue_discussions` - List discussions for an issue in a GitLab project
+79. `get_issue_link` - Get a specific issue link
+80. `create_issue_link` - Create an issue link between two issues
+81. `delete_issue_link` - Delete an issue link
+82. `list_namespaces` - List all namespaces available to the current user
+83. `get_namespace` - Get details of a namespace by ID or path
+84. `verify_namespace` - Verify if a namespace path exists
+85. `get_project` - Get details of a specific project
+86. `list_projects` - List projects accessible by the current user
+87. `update_project` - Update project settings such as description, visibility, default branch, and feature access levels
+88. `list_project_members` - List members of a GitLab project
+89. `list_labels` - List labels for a project
+90. `get_label` - Get a single label from a project
+91. `create_label` - Create a new label in a project
+92. `update_label` - Update an existing label in a project
+93. `delete_label` - Delete a label from a project
+94. `list_group_projects` - List projects in a GitLab group with filtering options
+95. `list_wiki_pages` - List wiki pages in a GitLab project
+96. `get_wiki_page` - Get details of a specific wiki page
+97. `create_wiki_page` - Create a new wiki page in a GitLab project
+98. `update_wiki_page` - Update an existing wiki page in a GitLab project
+99. `delete_wiki_page` - Delete a wiki page from a GitLab project
+100. `list_group_wiki_pages` - List wiki pages in a GitLab group
+101. `get_group_wiki_page` - Get details of a specific group wiki page
+102. `create_group_wiki_page` - Create a new wiki page in a GitLab group
+103. `update_group_wiki_page` - Update an existing wiki page in a GitLab group
+104. `delete_group_wiki_page` - Delete a wiki page from a GitLab group
+105. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
+106. `list_pipelines` - List pipelines in a GitLab project with filtering options
+107. `get_pipeline` - Get details of a specific pipeline in a GitLab project
+108. `list_deployments` - List deployments in a GitLab project with filtering options
+109. `get_deployment` - Get details of a specific deployment in a GitLab project
+110. `list_environments` - List environments in a GitLab project
+111. `get_environment` - Get details of a specific environment in a GitLab project
+112. `list_pipeline_jobs` - List all jobs in a specific pipeline
+113. `list_pipeline_trigger_jobs` - List all trigger jobs (bridges) in a specific pipeline that trigger downstream pipelines
+114. `get_pipeline_job` - Get details of a GitLab pipeline job number
+115. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job with optional pagination to limit context window usage
+116. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
+117. `validate_project_ci_lint` - Validate an existing `.gitlab-ci.yml` configuration for a project
+118. `list_ci_catalog_resources` - List GitLab CI/CD Catalog resources/components visible to the user
+119. `get_ci_catalog_resource` - Get details for a GitLab CI/CD Catalog resource, including versions and components
+120. `create_pipeline` - Create a new pipeline for a branch or tag
+121. `retry_pipeline` - Retry a failed or canceled pipeline
+122. `cancel_pipeline` - Cancel a running pipeline
+123. `play_pipeline_job` - Run a manual pipeline job
+124. `retry_pipeline_job` - Retry a failed or canceled pipeline job
+125. `cancel_pipeline_job` - Cancel a running pipeline job
+126. `list_job_artifacts` - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes
+127. `download_job_artifacts` - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path
+128. `get_job_artifact_file` - Get the content of a single file from a job's artifacts by its path within the archive
+129. `list_merge_requests` - List merge requests globally or in a specific GitLab project with filtering options (project_id is now optional)
+130. `list_milestones` - List milestones in a GitLab project with filtering options
+131. `get_milestone` - Get details of a specific milestone
+132. `create_milestone` - Create a new milestone in a GitLab project
+133. `edit_milestone` - Edit an existing milestone in a GitLab project
+134. `delete_milestone` - Delete a milestone from a GitLab project
+135. `get_milestone_issue` - Get issues associated with a specific milestone
+136. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
+137. `promote_milestone` - Promote a milestone to the next stage
+138. `get_milestone_burndown_events` - Get burndown events for a specific milestone
+139. `list_group_milestones` - List milestones in a GitLab group with filtering options
+140. `get_group_milestone` - Get details of a specific group milestone
+141. `create_group_milestone` - Create a new milestone in a GitLab group
+142. `edit_group_milestone` - Edit an existing group milestone
+143. `delete_group_milestone` - Delete a milestone from a GitLab group
+144. `get_group_milestone_issue` - Get issues associated with a specific group milestone
+145. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
+146. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
+147. `get_users` - Get GitLab user details by usernames
+148. `get_user` - Get user details by ID
+149. `whoami` - Get current authenticated user details
+150. `list_commits` - List repository commits with filtering options
+151. `get_commit` - Get details of a specific commit
+152. `get_commit_diff` - Get changes/diffs of a specific commit
+153. `get_file_blame` - Get git blame for a file at a given ref. Each entry maps a contiguous range of source lines to the commit that last changed them (id, author, authored_date, message). Use range_start/range_end to limit blame to specific lines.
+154. `list_commit_statuses` - List statuses for a specific commit
+155. `create_commit_status` - Create or update the status of a specific commit
+156. `list_group_iterations` - List group iterations with filtering options
+157. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
+158. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
+159. `health_check` - Verify server status and authentication
+160. `list_events` - List all events for the currently authenticated user
+161. `get_project_events` - List all visible events for a specified project
+162. `list_releases` - List all releases for a project
+163. `get_release` - Get a release by tag name
+164. `create_release` - Create a new release in a GitLab project
+165. `update_release` - Update an existing release in a GitLab project
+166. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
+167. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
+168. `download_release_asset` - Download a release asset file by direct asset path
+169. `list_tags` - List repository tags with filtering and pagination support
+170. `get_tag` - Get details of a specific repository tag
+171. `create_tag` - Create a new tag in the repository
+172. `delete_tag` - Delete a tag from the repository
+173. `get_tag_signature` - Get the signature of a signed tag
+174. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
+175. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
+176. `create_work_item` - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality
+177. `update_work_item` - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields
+178. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
+179. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
+180. `list_custom_field_definitions` - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item
+181. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
+182. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
+183. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
+184. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
+185. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
+186. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
+187. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
+188. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
+189. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
+190. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
+191. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
+192. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
+193. `list_webhook_events` - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details
+194. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
+195. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
+196. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
+197. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
+198. `list_project_variables` - List CI/CD variables for a project with optional environment scope filter
+199. `get_project_variable` - Get a single CI/CD variable from a project by key, with optional environment scope filter
+200. `create_project_variable` - Create a new CI/CD variable in a project
+201. `update_project_variable` - Update an existing CI/CD variable in a project, with optional filter to disambiguate by environment scope
+202. `delete_project_variable` - Delete a CI/CD variable from a project, with optional filter to disambiguate by environment scope
+203. `list_group_variables` - List CI/CD variables for a group with optional environment scope filter
+204. `get_group_variable` - Get a single CI/CD variable from a group by key, with optional environment scope filter
+205. `create_group_variable` - Create a new CI/CD variable in a group
+206. `update_group_variable` - Update an existing CI/CD variable in a group, with optional filter to disambiguate by environment scope
+207. `delete_group_variable` - Delete a CI/CD variable from a group, with optional filter to disambiguate by environment scope
+208. `get_dependency_proxy_settings` - Get dependency proxy settings for a group (enabled status, blob count, total size, image prefix, TTL policy)
+209. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
+210. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group with cursor-based pagination
+211. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
+212. `discover_tools` - Discover and activate additional tool categories for this session. Available categories: merge_requests, issues, repositories, branches, projects, labels, ci, groups, pipelines, milestones, wiki, releases, tags, users, workitems, webhooks, search, variables, dependency_proxy. Already-active categories are listed in the response.
 
 <!-- TOOLS-END -->
 

package/README.zh-CN.md

@@ -80,7 +80,7 @@ npm install -g @zereight/mcp-gitlab
 
 示例使用 `zereight-mcp-gitlab`，这是比旧的 `mcp-gitlab` 更不容易冲突的别名。如果 MCP 客户端找不到它，请使用 `which zereight-mcp-gitlab` 输出的绝对路径。
 
-如果不想全局安装，请将 `npx` 固定到上一个稳定版本（即文档推荐的版本），例如 `npx -y @zereight/mcp-gitlab@2.1.38`。如果始终想使用最新版本，请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时，服务器会在启动时通过 stderr 提示（可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭）。
+如果不想全局安装，请将 `npx` 固定到上一个稳定版本（即文档推荐的版本），例如 `npx -y @zereight/mcp-gitlab@2.1.41`。如果始终想使用最新版本，请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时，服务器会在启动时通过 stderr 提示（可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭）。
 
 #### 使用 CLI 参数（适用于环境变量有问题的客户端）
 

package/build/index.js

@@ -90,6 +90,8 @@ import { graphqlQueryContainsWriteOperation, graphqlQueryContainsDeleteOperation
 import { resolveNestedWikiUpdateTitle } from "./utils/wiki-title.js";
 import { redactSensitiveGitLabFields } from "./utils/redact-sensitive.js";
 import { checkForNewVersion } from "./utils/version-check.js";
+import { assertGitLabVersionAtLeast } from "./utils/gitlab-version-gate.js";
+import { buildBulkPublishDraftNotesBody, needsGitLab19_2BulkPublish, } from "./utils/bulk-publish-options.js";
 import { cleanMutuallyExclusiveIdUsernameOptions, LIST_MERGE_REQUESTS_ID_USERNAME_PAIRS, sanitizeToolArguments, } from "./utils/tool-args.js";
 import { parseSearchReplaceBlocks, applySearchReplace, applyUnifiedDiff, } from "./utils/patch-helper.js";
 import { requireBearerAuth } from "@modelcontextprotocol/sdk/server/auth/middleware/bearerAuth.js";
@@ -1122,12 +1124,17 @@ function parseAllowedGitLabApiUrls(value) {
 }
 function encodeGitLabPathSegment(value) {
     const segment = String(value);
+    let decodedSegment;
     try {
-        return encodeURIComponent(decodeURIComponent(segment));
+        decodedSegment = decodeURIComponent(segment);
     }
     catch {
-        return encodeURIComponent(segment);
+        decodedSegment = segment;
     }
+    if (decodedSegment === "." || decodedSegment === "..") {
+        throw new Error("GitLab URL path segments cannot be '.' or '..'");
+    }
+    return encodeURIComponent(decodedSegment);
 }
 function encodeGitLabPath(value) {
     return value.split("/").map(encodeGitLabPathSegment).join("/");
@@ -3060,7 +3067,7 @@ async function createMergeRequest(projectId, options) {
  */
 async function listDiscussions(projectId, resourceType, resourceIid, options = {}) {
     projectId = decodeURIComponent(projectId); // Decode project ID
-    const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/${resourceType}/${resourceIid}/discussions`);
+    const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/${resourceType}/${encodeGitLabPathSegment(resourceIid)}/discussions`);
     // Add query parameters for pagination and sorting
     if (options.page) {
         url.searchParams.append("page", options.page.toString());
@@ -3298,15 +3305,15 @@ async function deleteMergeRequestNote(projectId, mergeRequestIid, noteId) {
 function buildAwardEmojiPath(entity, projectId, entityIid, opts) {
     projectId = decodeURIComponent(projectId);
     const pp = encodeURIComponent(getEffectiveProjectId(projectId));
-    let path = `${getEffectiveApiUrl()}/projects/${pp}/${entity}/${entityIid}`;
+    let path = `${getEffectiveApiUrl()}/projects/${pp}/${entity}/${encodeGitLabPathSegment(entityIid)}`;
     if (opts?.noteId) {
         path = opts.discussionId
-            ? `${path}/discussions/${opts.discussionId}/notes/${opts.noteId}`
-            : `${path}/notes/${opts.noteId}`;
+            ? `${path}/discussions/${encodeGitLabPathSegment(opts.discussionId)}/notes/${encodeGitLabPathSegment(opts.noteId)}`
+            : `${path}/notes/${encodeGitLabPathSegment(opts.noteId)}`;
     }
     path += "/award_emoji";
     if (opts?.awardId)
-        path += `/${opts.awardId}`;
+        path += `/${encodeGitLabPathSegment(opts.awardId)}`;
     return path;
 }
 async function createRestAwardEmoji(path, name) {
@@ -4234,7 +4241,7 @@ async function createNote(projectId, noteableType, // specifies 'issue' or 'merg
 noteableIid, body) {
     projectId = decodeURIComponent(projectId); // Decode project ID
     // ⚙️ Response type can be adjusted according to the GitLab API documentation
-    const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/${noteableType}s/${noteableIid}/notes` // Using plural form (issues/merge_requests) as per GitLab API documentation
+    const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/${noteableType}s/${encodeGitLabPathSegment(noteableIid)}/notes` // Using plural form (issues/merge_requests) as per GitLab API documentation
     );
     const response = await fetch(url.toString(), {
         ...getFetchConfig(),
@@ -4254,7 +4261,8 @@ noteableIid, body) {
  * @returns {Promise<GitLabDraftNote[]>} Array of draft notes
  */
 async function getDraftNote(project_id, merge_request_iid, draft_note_id) {
-    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(project_id)}/merge_requests/${merge_request_iid}/draft_notes/${draft_note_id}`, { ...getFetchConfig() });
+    const effectiveProjectId = getEffectiveProjectId(decodeURIComponent(project_id));
+    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/merge_requests/${encodeGitLabPathSegment(merge_request_iid)}/draft_notes/${encodeGitLabPathSegment(draft_note_id)}`, { ...getFetchConfig() });
     if (!response.ok) {
         const errorText = await response.text();
         throw new Error(`GitLab API error: ${response.status} ${response.statusText}\n${errorText}`);
@@ -4418,19 +4426,49 @@ async function publishDraftNote(projectId, mergeRequestIid, draftNoteId) {
         };
     }
 }
+async function fetchGitLabInstanceVersion() {
+    try {
+        const response = await fetch(`${getEffectiveApiUrl()}/version`, {
+            ...getFetchConfig(),
+        });
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        if (typeof data === "object" &&
+            data !== null &&
+            "version" in data &&
+            typeof data.version === "string") {
+            return data.version;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Publish all draft notes for a merge request
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number|string} mergeRequestIid - The internal ID of the merge request
+ * @param {BulkPublishDraftNotesBody} options - Optional GitLab 19.2+ bulk_publish body fields
  * @returns {Promise<GitLabDiscussionNote[]>} Array of published notes
  */
-async function bulkPublishDraftNotes(projectId, mergeRequestIid) {
+async function bulkPublishDraftNotes(projectId, mergeRequestIid, options = {}) {
     projectId = decodeURIComponent(projectId);
     const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(getEffectiveProjectId(projectId))}/merge_requests/${encodeGitLabPathSegment(mergeRequestIid)}/draft_notes/bulk_publish`);
+    const body = buildBulkPublishDraftNotesBody(options);
+    if (needsGitLab19_2BulkPublish(body)) {
+        await assertGitLabVersionAtLeast({
+            major: 19,
+            minor: 2,
+            feature: "reviewer_state, note, and internal on bulk_publish_draft_notes",
+            retryHint: "Omit reviewer_state, note, and internal, then retry.",
+        }, fetchGitLabInstanceVersion);
+    }
     const response = await fetch(url.toString(), {
         ...getFetchConfig(),
         method: "POST", // Changed from PUT to POST
-        body: JSON.stringify({}), // Send empty body for POST request
+        body: JSON.stringify(body),
     });
     if (!response.ok) {
         const errorText = await response.text();
@@ -5323,7 +5361,7 @@ async function downloadJobArtifacts(projectId, jobId, localPath) {
         throw new Error(`Job artifacts not found. The job may not have produced artifacts or the job ID is invalid.`);
     }
     await handleGitLabError(response);
-    const filename = `artifacts_job_${jobId}.zip`;
+    const filename = `artifacts_job_${encodeGitLabPathSegment(jobId)}.zip`;
     const savePath = localPath ? path.join(localPath, filename) : filename;
     fs.mkdirSync(path.dirname(savePath), { recursive: true });
     if (!response.body) {
@@ -5345,7 +5383,7 @@ async function getJobArtifactFile(projectId, jobId, artifactPath) {
     const effectiveProjectId = getEffectiveProjectId(projectId);
     const encodedArtifactPath = artifactPath
         .split("/")
-        .map(segment => encodeURIComponent(segment))
+        .map(segment => encodeGitLabPathSegment(segment))
         .join("/");
     const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/jobs/${encodeGitLabPathSegment(jobId)}/artifacts/${encodedArtifactPath}`);
     const response = await fetch(url.toString(), {
@@ -6487,9 +6525,20 @@ function getImageMimeType(filename) {
     const ext = path.extname(filename).toLowerCase();
     return IMAGE_MIME_TYPES[ext] ?? null;
 }
+function getSafeAttachmentFilename(filename) {
+    if (!filename ||
+        filename === "." ||
+        filename === ".." ||
+        filename.includes("/") ||
+        filename.includes("\\")) {
+        throw new Error("Invalid filename: directory separators are not allowed.");
+    }
+    return filename;
+}
 async function downloadAttachment(projectId, secret, filename, localPath) {
     const effectiveProjectId = getEffectiveProjectId(projectId);
-    const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/uploads/${secret}/${filename}`);
+    const safeFilename = getSafeAttachmentFilename(filename);
+    const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/uploads/${encodeGitLabPathSegment(secret)}/${encodeGitLabPathSegment(safeFilename)}`);
     const response = await fetch(url.toString(), {
         ...getFetchConfig(),
         method: "GET",
@@ -6497,7 +6546,7 @@ async function downloadAttachment(projectId, secret, filename, localPath) {
     if (!response.ok) {
         await handleGitLabError(response);
     }
-    const mimeType = getImageMimeType(filename);
+    const mimeType = getImageMimeType(safeFilename);
     // For non-image files, always save to disk.
     // For image files, only save to disk if local_path is explicitly provided.
     if (!mimeType || localPath) {
@@ -6510,10 +6559,10 @@ async function downloadAttachment(projectId, secret, filename, localPath) {
                 normalizedLocalPath.includes(path.sep + ".." + path.sep)) {
                 throw new Error("Invalid local_path: directory traversal is not allowed.");
             }
-            savePath = path.join(normalizedLocalPath, filename);
+            savePath = path.join(normalizedLocalPath, safeFilename);
         }
         else {
-            savePath = filename;
+            savePath = safeFilename;
         }
         const dir = path.dirname(savePath);
         if (!fs.existsSync(dir)) {
@@ -6524,11 +6573,11 @@ async function downloadAttachment(projectId, secret, filename, localPath) {
             throw new Error("No response body from GitLab");
         }
         await streamPipeline(response.body, fs.createWriteStream(savePath));
-        return { buffer: Buffer.alloc(0), filename, mimeType, savedPath: savePath };
+        return { buffer: Buffer.alloc(0), filename: safeFilename, mimeType, savedPath: savePath };
     }
     // Images returned inline — buffer into memory for base64 encoding
     const buffer = Buffer.from(await response.arrayBuffer());
-    return { buffer, filename, mimeType };
+    return { buffer, filename: safeFilename, mimeType };
 }
 /**
  * List all events for the currently authenticated user
@@ -6605,7 +6654,7 @@ async function listReleases(projectId, options = {}) {
  */
 async function getRelease(projectId, tagName, includeHtmlDescription) {
     const effectiveProjectId = getEffectiveProjectId(projectId);
-    const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeURIComponent(tagName)}`);
+    const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeGitLabPathSegment(tagName)}`);
     if (includeHtmlDescription !== undefined) {
         url.searchParams.append("include_html_description", includeHtmlDescription.toString());
     }
@@ -6644,7 +6693,7 @@ async function createRelease(projectId, options) {
  */
 async function updateRelease(projectId, tagName, options) {
     const effectiveProjectId = getEffectiveProjectId(projectId);
-    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeURIComponent(tagName)}`, {
+    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeGitLabPathSegment(tagName)}`, {
         ...getFetchConfig(),
         method: "PUT",
         body: JSON.stringify(options),
@@ -6662,7 +6711,7 @@ async function updateRelease(projectId, tagName, options) {
  */
 async function deleteRelease(projectId, tagName) {
     const effectiveProjectId = getEffectiveProjectId(projectId);
-    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeURIComponent(tagName)}`, {
+    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeGitLabPathSegment(tagName)}`, {
         ...getFetchConfig(),
         method: "DELETE",
     });
@@ -6678,7 +6727,7 @@ async function deleteRelease(projectId, tagName) {
  */
 async function createReleaseEvidence(projectId, tagName) {
     const effectiveProjectId = getEffectiveProjectId(projectId);
-    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeURIComponent(tagName)}/evidence`, {
+    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeGitLabPathSegment(tagName)}/evidence`, {
         ...getFetchConfig(),
         method: "POST",
     });
@@ -6694,7 +6743,7 @@ async function createReleaseEvidence(projectId, tagName) {
  */
 async function downloadReleaseAsset(projectId, tagName, directAssetPath) {
     const effectiveProjectId = getEffectiveProjectId(projectId);
-    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeURIComponent(tagName)}/downloads/${directAssetPath}`, {
+    const response = await fetch(`${getEffectiveApiUrl()}/projects/${encodeURIComponent(effectiveProjectId)}/releases/${encodeGitLabPathSegment(tagName)}/downloads/${encodeGitLabPath(directAssetPath)}`, {
         ...getFetchConfig(),
     });
     await handleGitLabError(response);
@@ -7595,8 +7644,8 @@ async function handleToolCall(params) {
             }
             case "bulk_publish_draft_notes": {
                 const args = BulkPublishDraftNotesSchema.parse(params.arguments);
-                const { project_id, merge_request_iid } = args;
-                const publishedNotes = await bulkPublishDraftNotes(project_id, merge_request_iid);
+                const { project_id, merge_request_iid, ...options } = args;
+                const publishedNotes = await bulkPublishDraftNotes(project_id, merge_request_iid, options);
                 return {
                     content: [{ type: "text", text: JSON.stringify(publishedNotes) }],
                 };
@@ -9536,13 +9585,16 @@ async function startStreamableHTTPServer() {
         clearAuthTimeout(sessionId);
         // Set new timeout
         authTimeouts[sessionId] = setTimeout(() => {
-            if (authBySession[sessionId]) {
-                logger.info(`Session ${sessionId}: auth token expired after ${SESSION_TIMEOUT_SECONDS}s of inactivity`);
+            const authData = authBySession[sessionId];
+            const transport = streamableTransports[sessionId];
+            if (authData || transport) {
+                logger.info(authData
+                    ? `Session ${sessionId}: auth token expired after ${SESSION_TIMEOUT_SECONDS}s of inactivity`
+                    : `Session ${sessionId}: unauthenticated discovery expired after ${SESSION_TIMEOUT_SECONDS}s`);
                 delete authBySession[sessionId];
                 delete authTimeouts[sessionId];
                 metrics.expiredSessions++;
                 // Close the transport to free the slot; without this, stale sessions accumulate and exhaust MAX_SESSIONS.
-                const transport = streamableTransports[sessionId];
                 if (transport) {
                     transport.close().catch(err => {
                         logger.error(`Error closing transport for expired session ${sessionId}:`, err);
@@ -9975,10 +10027,12 @@ async function startStreamableHTTPServer() {
             return;
         }
         const newRemoteAuthData = !sessionId && REMOTE_AUTHORIZATION ? parseAuthHeaders(req) : null;
+        let unauthenticatedDiscoveryRequested = false;
         let remoteAuthValidatedForInit = false;
         if (!sessionId && REMOTE_AUTHORIZATION) {
             const allowUnauthenticatedDiscovery = GITLAB_ALLOW_UNAUTHENTICATED_TOOL_DISCOVERY &&
                 isUnauthenticatedDiscoveryRequestBody(req.body);
+            unauthenticatedDiscoveryRequested = allowUnauthenticatedDiscovery && !newRemoteAuthData;
             if (!newRemoteAuthData && !allowUnauthenticatedDiscovery) {
                 metrics.authFailures++;
                 res.status(401).json({
@@ -10147,6 +10201,9 @@ async function startStreamableHTTPServer() {
                                     logger.info(`Session ${newSessionId}: stored ${authData.header} header`);
                                     setAuthTimeout(newSessionId);
                                 }
+                                else if (unauthenticatedDiscoveryRequested) {
+                                    setAuthTimeout(newSessionId);
+                                }
                             }
                             // Store OAuth token for newly created session in MCP OAuth mode.
                             // If Private-Token or JOB-TOKEN headers are present, prefer them.

package/build/schemas.js

@@ -2547,26 +2547,31 @@ export const MergeRequestThreadPositionSchema = z.object({
 });
 const optionalMergeRequestThreadPosition = z.preprocess(omitIncompleteMergeRequestPosition, MergeRequestThreadPositionSchema.optional());
 // Draft Notes API schemas
+// Response shape follows Draft Notes API (not Notes API): note, author_id,
+// line_code, merge_request_id, commit_id — no created_at/updated_at.
 export const GitLabDraftNoteSchema = z
     .object({
     id: z.coerce.string(),
+    author_id: z.coerce.number().nullable().optional(),
     author: GitLabUserSchema.optional(),
     body: z.string().optional(),
-    note: z.string().optional(), // Some APIs might use 'note' instead of 'body'
-    created_at: z.string().optional(),
-    updated_at: z.string().optional(),
+    note: z.string().optional(), // Draft Notes API uses 'note'; keep 'body' for callers
+    line_code: z.string().nullable().optional(),
+    merge_request_id: z.coerce.number().nullable().optional(),
+    commit_id: z.string().nullable().optional(),
     discussion_id: z.string().nullable().optional(),
     position: z.record(z.unknown()).nullable().optional(),
     resolve_discussion: z.coerce.boolean().optional(),
 })
     .transform(data => ({
-    // Normalize the response to always have consistent field names
     id: data.id,
+    author_id: data.author_id ?? null,
     author: data.author,
     body: data.body || data.note || "",
-    created_at: data.created_at || "",
-    updated_at: data.updated_at || "",
-    discussion_id: data.discussion_id || null,
+    line_code: data.line_code ?? null,
+    merge_request_id: data.merge_request_id ?? null,
+    commit_id: data.commit_id ?? null,
+    discussion_id: data.discussion_id ?? null,
     position: data.position,
     resolve_discussion: data.resolve_discussion,
 }));
@@ -2617,6 +2622,18 @@ export const PublishDraftNoteSchema = ProjectParamsSchema.extend({
 // Bulk publish draft notes schema
 export const BulkPublishDraftNotesSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().describe("The IID of a merge request"),
+    reviewer_state: z
+        .enum(["requested_changes", "reviewed"])
+        .optional()
+        .describe("Set reviewer review state after publishing (GitLab 19.2+). Does not record a formal approval. Works even with no draft notes."),
+    note: z
+        .string()
+        .optional()
+        .describe("Summary note body to post on the merge request (GitLab 19.2+)"),
+    internal: z.coerce
+        .boolean()
+        .optional()
+        .describe("If true, the summary note is internal (GitLab 19.2+, default false)"),
 });
 // Schema for creating a new merge request thread
 export const CreateMergeRequestThreadSchema = ProjectParamsSchema.extend({

package/build/test/draft-note-schema.test.js

@@ -0,0 +1,44 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { GitLabDraftNoteSchema } from "../schemas.js";
+test("draft note schema keeps Draft Notes API fields and drops fake timestamps", () => {
+    const parsed = GitLabDraftNoteSchema.parse({
+        id: 42,
+        author_id: 7,
+        note: "looks wrong on this line",
+        line_code: "a1b2c3d4e5f6_12_17",
+        merge_request_id: 99,
+        commit_id: "abc123",
+        discussion_id: null,
+        position: { new_path: "src/app.ts", new_line: 17 },
+        resolve_discussion: false,
+        // Notes-API leftovers that Draft Notes API never returns — must be stripped
+        created_at: "2024-01-01T00:00:00Z",
+        updated_at: "2024-01-02T00:00:00Z",
+    });
+    assert.equal(parsed.id, "42");
+    assert.equal(parsed.author_id, 7);
+    assert.equal(parsed.body, "looks wrong on this line");
+    assert.equal(parsed.line_code, "a1b2c3d4e5f6_12_17");
+    assert.equal(parsed.merge_request_id, 99);
+    assert.equal(parsed.commit_id, "abc123");
+    assert.equal(parsed.discussion_id, null);
+    assert.equal(parsed.resolve_discussion, false);
+    assert.equal("created_at" in parsed, false);
+    assert.equal("updated_at" in parsed, false);
+});
+test("draft note schema preserves null line_code for unresolved positions", () => {
+    const parsed = GitLabDraftNoteSchema.parse({
+        id: "43",
+        author_id: 7,
+        note: "orphan draft",
+        line_code: null,
+        merge_request_id: 99,
+        commit_id: null,
+        discussion_id: null,
+        position: null,
+        resolve_discussion: false,
+    });
+    assert.equal(parsed.line_code, null);
+    assert.equal(parsed.commit_id, null);
+});

package/build/test/path-segment-encoding.test.js

@@ -14,6 +14,10 @@ const rawPathSegmentPatterns = [
     "/jobs/${jobId}",
     "/pipelines/${pipelineId}",
     "/milestones/${milestoneId}",
+    "/merge_requests/${merge_request_iid}/draft_notes/${draft_note_id}",
+    "/uploads/${secret}/${filename}",
+    "/downloads/${directAssetPath}",
+    "/${entity}/${entityIid}",
 ];
 test("GitLab URL path IDs are encoded before interpolation", () => {
     for (const pattern of rawPathSegmentPatterns) {

package/build/test/streamable-http-unauthenticated-discovery.test.js

@@ -106,6 +106,21 @@ describe("Streamable HTTP unauthenticated tool discovery", { timeout: 20_000 },
         assert.ok(Array.isArray(listResponse.data.result?.tools), "tools/list should return tools");
         assert.ok(listResponse.data.result.tools.length > 0, "tools/list should not be empty");
     });
+    test("expires unauthenticated discovery sessions and frees capacity", async () => {
+        const { server, mcpUrl } = await launchRemoteAuthServer({
+            GITLAB_ALLOW_UNAUTHENTICATED_TOOL_DISCOVERY: "true",
+            MAX_SESSIONS: "1",
+            SESSION_TIMEOUT_SECONDS: "1",
+        });
+        servers.push(server);
+        await initialize(mcpUrl);
+        await new Promise(resolve => setTimeout(resolve, 2_000));
+        const healthResponse = await fetch(mcpUrl.replace("/mcp", "/health"));
+        assert.strictEqual(healthResponse.status, 200);
+        const nextSession = await rawMcpRequest(mcpUrl, initializeBody);
+        assert.strictEqual(nextSession.status, 200, nextSession.text);
+        assert.ok(nextSession.sessionId, "expired discovery session should free capacity");
+    });
     test("still blocks unauthenticated tools/call when discovery is enabled", async () => {
         const { server, mcpUrl } = await launchRemoteAuthServer({
             GITLAB_ALLOW_UNAUTHENTICATED_TOOL_DISCOVERY: "true",

package/build/test/test-download-attachment.js

@@ -125,6 +125,14 @@ describe('download_attachment', () => {
             raw.result.content.some(c => typeof c.text === 'string' && c.text.toLowerCase().includes('traversal'));
         assert.ok(isRpcError || isContentError, 'Should return an error mentioning directory traversal');
     });
+    test('filename with directory traversal is rejected before writing to disk', async () => {
+        const raw = await callDownloadAttachment({ project_id: TEST_PROJECT_ID, secret: TEST_SECRET, filename: 'image.png#../../owned.txt' }, env);
+        const isRpcError = typeof raw.error?.message === 'string' &&
+            raw.error.message.toLowerCase().includes('filename');
+        const isContentError = Array.isArray(raw.result?.content) &&
+            raw.result.content.some(c => typeof c.text === 'string' && c.text.toLowerCase().includes('filename'));
+        assert.ok(isRpcError || isContentError, 'Should return an error mentioning filename validation');
+    });
     test('non-existent local_path directory is auto-created before saving', async () => {
         const baseDir = `omc-test-newdir-${RUN_ID}`;
         const localPath = `${baseDir}/subdir`;

package/build/test/test-geteffectiveprojectid.js

@@ -582,7 +582,7 @@ describe('getEffectiveProjectId', { concurrency: 1 }, () => {
                     REMOTE_AUTHORIZATION: 'true',
                     GITLAB_API_URL: `${mockGitLabUrl}/api/v4`,
                     GITLAB_ALLOWED_PROJECT_IDS: DEFAULT_PROJECT_ID,
-                    GITLAB_TOOLSETS: 'variables',
+                    GITLAB_TOOLSETS: 'variables,merge_requests,issues,pipelines',
                 }
             });
             servers.push(server);
@@ -657,6 +657,32 @@ describe('getEffectiveProjectId', { concurrency: 1 }, () => {
             const project = JSON.parse(content.text);
             assert.strictEqual(project.id.toString(), DEFAULT_PROJECT_ID, 'Should use default project');
         });
+        test('should enforce the project allowlist for get_draft_note', async () => {
+            await assert.rejects(client.callTool('get_draft_note', {
+                project_id: OTHER_PROJECT_ID,
+                merge_request_iid: '1',
+                draft_note_id: '1',
+            }), /Access denied/);
+        });
+        test('should reject dot path segments before making GitLab requests', async () => {
+            const calls = [
+                {
+                    name: 'get_draft_note',
+                    args: { project_id: DEFAULT_PROJECT_ID, merge_request_iid: '..', draft_note_id: '1' },
+                },
+                {
+                    name: 'get_job_artifact_file',
+                    args: { project_id: DEFAULT_PROJECT_ID, job_id: '1', artifact_path: '../file.txt' },
+                },
+                {
+                    name: 'list_issue_emoji_reactions',
+                    args: { project_id: DEFAULT_PROJECT_ID, issue_iid: '..' },
+                },
+            ];
+            for (const { name, args } of calls) {
+                await assert.rejects(client.callTool(name, args), /path segments/);
+            }
+        });
     });
     describe('GITLAB_READ_ONLY_MODE enforces read-only for all write tools', () => {
         let mcpUrl;

package/build/test/utils/bulk-publish-options.test.js

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import { describe, test } from "node:test";
+import { buildBulkPublishDraftNotesBody, needsGitLab19_2BulkPublish, } from "../../utils/bulk-publish-options.js";
+describe("When buildBulkPublishDraftNotesBody runs", () => {
+    describe("with no-op defaults", () => {
+        test("should omit internal false and empty note", () => {
+            assert.deepEqual(buildBulkPublishDraftNotesBody({ internal: false, note: "" }), {});
+        });
+    });
+    describe("with meaningful 19.2 fields", () => {
+        test("should keep reviewer_state, note, and internal true", () => {
+            assert.deepEqual(buildBulkPublishDraftNotesBody({
+                reviewer_state: "reviewed",
+                note: "LGTM",
+                internal: true,
+            }), { reviewer_state: "reviewed", note: "LGTM", internal: true });
+        });
+    });
+});
+describe("When needsGitLab19_2BulkPublish runs", () => {
+    describe("with an empty body", () => {
+        test("should return false", () => {
+            assert.equal(needsGitLab19_2BulkPublish({}), false);
+            assert.equal(needsGitLab19_2BulkPublish(buildBulkPublishDraftNotesBody({ internal: false })), false);
+        });
+    });
+    describe("with a non-empty body", () => {
+        test("should return true", () => {
+            assert.equal(needsGitLab19_2BulkPublish({ reviewer_state: "reviewed" }), true);
+        });
+    });
+});

package/build/test/utils/gitlab-version-gate.test.js

@@ -0,0 +1,74 @@
+import assert from "node:assert/strict";
+import { describe, test } from "node:test";
+import { assertGitLabVersionAtLeast, isGitLabVersionAtLeast, parseGitLabVersion, } from "../../utils/gitlab-version-gate.js";
+function versionFetcher(version) {
+    return async () => version;
+}
+function bulkPublishRequirement() {
+    return {
+        major: 19,
+        minor: 2,
+        feature: "reviewer_state, note, and internal on bulk_publish_draft_notes",
+        retryHint: "Omit reviewer_state, note, and internal, then retry.",
+    };
+}
+describe("When parseGitLabVersion runs", () => {
+    describe("with a release suffix", () => {
+        test("should parse major.minor.patch from ee builds", () => {
+            assert.deepEqual(parseGitLabVersion("19.2.0-ee"), {
+                major: 19,
+                minor: 2,
+                patch: 0,
+            });
+        });
+    });
+    describe("with a malformed string", () => {
+        test("should return null", () => {
+            assert.equal(parseGitLabVersion("unknown"), null);
+            assert.equal(parseGitLabVersion(""), null);
+        });
+    });
+});
+describe("When isGitLabVersionAtLeast compares versions", () => {
+    describe("with a version at or above the floor", () => {
+        test("should return true", () => {
+            assert.equal(isGitLabVersionAtLeast("19.2.0-ee", 19, 2), true);
+            assert.equal(isGitLabVersionAtLeast("19.3.1", 19, 2), true);
+            assert.equal(isGitLabVersionAtLeast("20.0.0", 19, 2), true);
+        });
+    });
+    describe("with a version below the floor", () => {
+        test("should return false", () => {
+            assert.equal(isGitLabVersionAtLeast("19.1.9-ee", 19, 2), false);
+            assert.equal(isGitLabVersionAtLeast("17.5.0", 19, 2), false);
+        });
+    });
+    describe("with an unparseable version", () => {
+        test("should return null", () => {
+            assert.equal(isGitLabVersionAtLeast("not-a-version", 19, 2), null);
+        });
+    });
+});
+describe("When assertGitLabVersionAtLeast runs", () => {
+    describe("with an older instance version", () => {
+        test("should throw a retryable error", async () => {
+            await assert.rejects(() => assertGitLabVersionAtLeast(bulkPublishRequirement(), versionFetcher("17.5.0-ee")), (error) => {
+                assert.ok(error instanceof Error);
+                assert.match(error.message, /GitLab 19\.2\+/);
+                assert.match(error.message, /17\.5\.0-ee/);
+                assert.match(error.message, /Omit reviewer_state/);
+                return true;
+            });
+        });
+    });
+    describe("with a new enough instance version", () => {
+        test("should resolve without throwing", async () => {
+            await assertGitLabVersionAtLeast(bulkPublishRequirement(), versionFetcher("19.2.0-ee"));
+        });
+    });
+    describe("with an unknown instance version", () => {
+        test("should fail open and resolve", async () => {
+            await assertGitLabVersionAtLeast(bulkPublishRequirement(), versionFetcher(null));
+        });
+    });
+});

package/build/tools/registry.js

@@ -267,7 +267,7 @@ export const allTools = [
     },
     {
         name: "bulk_publish_draft_notes",
-        description: "Publish all draft notes for a merge request",
+        description: "Publish all draft notes for a merge request. Optionally sets reviewer_state and posts a summary note (GitLab 19.2+). Can set reviewer_state even with no drafts.",
         inputSchema: toJSONSchema(BulkPublishDraftNotesSchema),
     },
     // --- Merge request emoji reaction tools ---

package/build/utils/bulk-publish-options.js

@@ -0,0 +1,21 @@
+/**
+ * Build the POST body. Omit no-op defaults (`internal: false`, empty `note`)
+ * so older GitLab instances are not sent unknown fields.
+ */
+export function buildBulkPublishDraftNotesBody(options) {
+    const body = {};
+    if (options.reviewer_state !== undefined) {
+        body.reviewer_state = options.reviewer_state;
+    }
+    if (options.note) {
+        body.note = options.note;
+    }
+    if (options.internal === true) {
+        body.internal = true;
+    }
+    return body;
+}
+/** True when the body needs GitLab 19.2+ bulk_publish fields. */
+export function needsGitLab19_2BulkPublish(body) {
+    return Object.keys(body).length > 0;
+}

package/build/utils/gitlab-version-gate.js

@@ -0,0 +1,47 @@
+/**
+ * Call-time GitLab instance version gate.
+ *
+ * Use when a tool exposes optional params that only exist on newer GitLab.
+ * Schemas stay static; check before the API call and throw a retryable error.
+ * Fail-open when the instance version cannot be fetched or parsed.
+ */
+const VERSION_CORE = /^(\d+)\.(\d+)(?:\.(\d+))?/;
+/** Parse strings like "19.2.0-ee" / "17.5.3". Returns null if unparseable. */
+export function parseGitLabVersion(version) {
+    const match = VERSION_CORE.exec(version.trim());
+    if (!match)
+        return null;
+    const major = Number.parseInt(match[1], 10);
+    const minor = Number.parseInt(match[2], 10);
+    const patch = match[3] ? Number.parseInt(match[3], 10) : 0;
+    if (!Number.isFinite(major) || !Number.isFinite(minor) || !Number.isFinite(patch)) {
+        return null;
+    }
+    return { major, minor, patch };
+}
+/**
+ * Compare a GitLab version string against a major.minor floor.
+ * Returns null when the version string cannot be parsed.
+ */
+export function isGitLabVersionAtLeast(version, major, minor) {
+    const parsed = parseGitLabVersion(version);
+    if (!parsed)
+        return null;
+    if (parsed.major !== major)
+        return parsed.major > major;
+    return parsed.minor >= minor;
+}
+/**
+ * Throws when the instance is known to be older than `requirement`.
+ * Does nothing when the version is unknown (fail-open).
+ */
+export async function assertGitLabVersionAtLeast(requirement, fetchVersion) {
+    const current = await fetchVersion();
+    if (current === null)
+        return;
+    const ok = isGitLabVersionAtLeast(current, requirement.major, requirement.minor);
+    if (ok === null || ok)
+        return;
+    throw new Error(`GitLab ${requirement.major}.${requirement.minor}+ required for ${requirement.feature} ` +
+        `(instance reports ${current}). ${requirement.retryHint}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.1.40",
+  "version": "2.1.42",
   "mcpName": "io.github.zereight/gitlab-mcp",
   "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
   "keywords": [