@zereight/mcp-gitlab 2.1.30 → 2.1.39

package/README.ko.md

@@ -68,6 +68,7 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
 서버를 한 번 설치하세요.
 
 ```shell
+brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp
 brew install zereight/gitlab-mcp/zereight-mcp-gitlab
 ```
 
@@ -79,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.29`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
+전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.1.38`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
 
 #### CLI 인자 사용하기(환경 변수 문제가 있는 클라이언트용)
 
@@ -300,6 +301,7 @@ Authorization: Bearer glpat-xxxxxxxxxxxxxxxxxxxx
 - **로컬 PAT**: `GITLAB_PERSONAL_ACCESS_TOKEN`, `GITLAB_API_URL`
 - **로컬 OAuth**: `GITLAB_USE_OAUTH=true`, `GITLAB_OAUTH_CLIENT_ID`, `GITLAB_OAUTH_REDIRECT_URI`, `GITLAB_API_URL`
 - **원격 멀티 유저 HTTP**: `STREAMABLE_HTTP=true`, `REMOTE_AUTHORIZATION=true`(또는 `GITLAB_MCP_OAUTH=true`), `MCP_TRUST_PROXY=true`(리버스 프록시 뒤), `MAX_REQUESTS_PER_MINUTE=300`, `MCP_SERVER_URL` 또는 `MCP_ALLOWED_HOSTS`, `HOST`, `PORT`
+- **여러 배포를 동시에 운영**: 배포마다 `MCP_SERVER_NAME`을 다르게 설정(예: `gitlab-selfhosted-readonly`)하면 클라이언트, 로그, 텔레메트리에서 서로 구분할 수 있습니다
 - **멀티 Pod HPA (stateless)**: 위 설정 + `OAUTH_STATELESS_MODE=true`, `OAUTH_STATELESS_SECRET`(모든 Pod에서 동일). [Stateless Mode](./docs/configuration/stateless-mode.md) 참고.
 
 자주 참조하는 변수:

package/README.md

@@ -68,6 +68,7 @@ For the simplest local setup, start with a Personal Access Token. For browser-ba
 Install the server once:
 
 ```shell
+brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp
 brew install zereight/gitlab-mcp/zereight-mcp-gitlab
 ```
 
@@ -79,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.29`. 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.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`).
 
 #### Using CLI Arguments (for clients with env var issues)
 
@@ -332,6 +333,7 @@ Most users only need one of these starting sets:
 - **Local PAT**: `GITLAB_PERSONAL_ACCESS_TOKEN`, `GITLAB_API_URL`
 - **Local OAuth**: `GITLAB_USE_OAUTH=true`, `GITLAB_OAUTH_CLIENT_ID`, `GITLAB_OAUTH_REDIRECT_URI`, `GITLAB_API_URL`
 - **Remote multi-user HTTP**: `STREAMABLE_HTTP=true`, `REMOTE_AUTHORIZATION=true` (or `GITLAB_MCP_OAUTH=true`), `MCP_TRUST_PROXY=true` (behind a reverse proxy), `MAX_REQUESTS_PER_MINUTE=300`, `MCP_SERVER_URL` or `MCP_ALLOWED_HOSTS`, `HOST`, `PORT`
+- **Multiple side-by-side deployments**: set a distinct `MCP_SERVER_NAME` per instance (e.g. `gitlab-selfhosted-readonly`) so clients, logs, and telemetry can tell them apart
 - **Multi-pod HPA (stateless)**: above + `OAUTH_STATELESS_MODE=true`, `OAUTH_STATELESS_SECRET` (same across all pods). See [Stateless Mode](./docs/configuration/stateless-mode.md).
 
 Commonly referenced variables:
@@ -641,73 +643,81 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
 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_wiki_pages` - List wiki pages in a GitLab project
-105. `get_wiki_page` - Get details of a specific wiki page
-106. `create_wiki_page` - Create a new wiki page in a GitLab project
-107. `update_wiki_page` - Update an existing wiki page in a GitLab project
-108. `delete_wiki_page` - Delete a wiki page from a GitLab project
-109. `list_group_wiki_pages` - List wiki pages in a GitLab group
-110. `get_group_wiki_page` - Get details of a specific group wiki page
-111. `create_group_wiki_page` - Create a new wiki page in a GitLab group
-112. `update_group_wiki_page` - Update an existing wiki page in a GitLab group
-113. `delete_group_wiki_page` - Delete a wiki page from a GitLab group
-114. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
-115. `list_commits` - List repository commits with filtering options
-116. `get_commit` - Get details of a specific commit
-117. `get_commit_diff` - Get changes/diffs of a specific commit
-118. `list_commit_statuses` - List statuses for a specific commit
-119. `create_commit_status` - Create or update the status of a specific commit
-120. `list_releases` - List all releases for a project
-121. `get_release` - Get a release by tag name
-122. `create_release` - Create a new release in a GitLab project
-123. `update_release` - Update an existing release in a GitLab project
-124. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
-125. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
-126. `download_release_asset` - Download a release asset file by direct asset path
-127. `list_tags` - List repository tags with filtering and pagination support
-128. `get_tag` - Get details of a specific repository tag
-129. `create_tag` - Create a new tag in the repository
-130. `delete_tag` - Delete a tag from the repository
-131. `get_tag_signature` - Get the signature of a signed tag
-132. `get_users` - Get GitLab user details by usernames
-133. `list_events` - List all events for the currently authenticated user
-134. `get_project_events` - List all visible events for a specified project
-135. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
-136. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
-137. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
-138. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
-139. `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
-140. `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
-141. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
-142. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
-143. `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
-144. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
-145. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
-146. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
-147. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
-148. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
-149. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
-150. `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
-151. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
-152. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
-153. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
-154. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
-155. `execute_graphql` - Execute a GitLab GraphQL query
-156. `list_merge_request_pipelines` - List pipelines for a merge request with pagination support
-157. `list_project_variables` - List CI/CD variables for a project with optional environment scope filter
-158. `get_project_variable` - Get a single CI/CD variable from a project by key, with optional environment scope filter
-159. `create_project_variable` - Create a new CI/CD variable in a project
-160. `update_project_variable` - Update an existing CI/CD variable in a project, with optional filter to disambiguate by environment scope
-161. `delete_project_variable` - Delete a CI/CD variable from a project, with optional filter to disambiguate by environment scope
-162. `list_group_variables` - List CI/CD variables for a group with optional environment scope filter
-163. `get_group_variable` - Get a single CI/CD variable from a group by key, with optional environment scope filter
-164. `create_group_variable` - Create a new CI/CD variable in a group
-165. `update_group_variable` - Update an existing CI/CD variable in a group, with optional filter to disambiguate by environment scope
-166. `delete_group_variable` - Delete a CI/CD variable from a group, with optional filter to disambiguate by environment scope
-167. `get_dependency_proxy_settings` - Get dependency proxy settings for a group (enabled status, blob count, total size, image prefix, TTL policy)
-168. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
-169. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group with cursor-based pagination
-170. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
+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
 
 <!-- TOOLS-END -->
 

package/README.zh-CN.md

@@ -68,6 +68,7 @@
 安装服务器：
 
 ```shell
+brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp
 brew install zereight/gitlab-mcp/zereight-mcp-gitlab
 ```
 
@@ -79,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.29`。如果始终想使用最新版本，请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时，服务器会在启动时通过 stderr 提示（可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭）。
+如果不想全局安装，请将 `npx` 固定到上一个稳定版本（即文档推荐的版本），例如 `npx -y @zereight/mcp-gitlab@2.1.38`。如果始终想使用最新版本，请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时，服务器会在启动时通过 stderr 提示（可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭）。
 
 #### 使用 CLI 参数（适用于环境变量有问题的客户端）
 
@@ -300,6 +301,7 @@ Authorization: Bearer glpat-xxxxxxxxxxxxxxxxxxxx
 - **本地 PAT**：`GITLAB_PERSONAL_ACCESS_TOKEN`, `GITLAB_API_URL`
 - **本地 OAuth**：`GITLAB_USE_OAUTH=true`, `GITLAB_OAUTH_CLIENT_ID`, `GITLAB_OAUTH_REDIRECT_URI`, `GITLAB_API_URL`
 - **远程多用户 HTTP**：`STREAMABLE_HTTP=true`, `REMOTE_AUTHORIZATION=true`（或 `GITLAB_MCP_OAUTH=true`）, `MCP_TRUST_PROXY=true`（反向代理后）, `MAX_REQUESTS_PER_MINUTE=300`, `MCP_SERVER_URL` 或 `MCP_ALLOWED_HOSTS`, `HOST`, `PORT`
+- **并行运行多个部署**：为每个实例设置不同的 `MCP_SERVER_NAME`（例如 `gitlab-selfhosted-readonly`），以便在客户端、日志和遥测数据中区分它们
 - **多 Pod HPA（stateless）**：上述配置 + `OAUTH_STATELESS_MODE=true`, `OAUTH_STATELESS_SECRET`（所有 Pod 相同）。参见 [Stateless Mode](./docs/configuration/stateless-mode.md)。
 
 常用变量：