@zereight/mcp-gitlab 2.3.20-next.198 → 2.3.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ko.md +1 -1
- package/README.md +1 -1
- package/README.pt-BR.md +1 -1
- package/README.zh-CN.md +1 -1
- package/build/utils/list-summary.js +75 -0
- package/package.json +1 -1
package/README.ko.md
CHANGED
|
@@ -252,7 +252,7 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
|
|
|
252
252
|
|
|
253
253
|
예시는 기존 `mcp-gitlab`보다 충돌 가능성이 낮은 `zereight-mcp-gitlab` 별칭을 사용합니다. MCP 클라이언트가 찾지 못하면 `which zereight-mcp-gitlab`의 절대 경로를 사용하세요.
|
|
254
254
|
|
|
255
|
-
전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.3.
|
|
255
|
+
전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.3.19`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. `main`에 머지된 수정을 다음 안정 버전 전에 확인하려면 프리릴리스 빌드인 `npx -y @zereight/mcp-gitlab@next`를 사용하세요(운영 환경용이 아닙니다). 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
|
|
256
256
|
|
|
257
257
|
#### Claude Desktop 원클릭 설치(MCP Bundle)
|
|
258
258
|
|
package/README.md
CHANGED
|
@@ -258,7 +258,7 @@ The store path is pinned by your lock file; update it with `nix flake update git
|
|
|
258
258
|
|
|
259
259
|
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`.
|
|
260
260
|
|
|
261
|
-
No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.
|
|
261
|
+
No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.19`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. To try a fix merged to `main` before the next stable release, use `npx -y @zereight/mcp-gitlab@next`, a pre-release build that is not meant for production. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
|
|
262
262
|
|
|
263
263
|
#### Claude Desktop one-click install (MCP Bundle)
|
|
264
264
|
|
package/README.pt-BR.md
CHANGED
|
@@ -252,7 +252,7 @@ O caminho no store é fixado pelo seu lock file; atualize-o com `nix flake updat
|
|
|
252
252
|
|
|
253
253
|
Os exemplos usam `zereight-mcp-gitlab`, um alias com menor chance de conflito que o binário legado `mcp-gitlab`. Se o seu cliente MCP não o encontrar, use o caminho absoluto retornado por `which zereight-mcp-gitlab`.
|
|
254
254
|
|
|
255
|
-
Não quer instalar globalmente? Fixe o `npx` na versão estável anterior (a versão recomendada por esta documentação), por exemplo `npx -y @zereight/mcp-gitlab@2.3.
|
|
255
|
+
Não quer instalar globalmente? Fixe o `npx` na versão estável anterior (a versão recomendada por esta documentação), por exemplo `npx -y @zereight/mcp-gitlab@2.3.19`. Se quiser sempre a versão mais recente, use `npx -y @zereight/mcp-gitlab@latest`. Para testar uma correção já mesclada na `main` antes da próxima versão estável, use `npx -y @zereight/mcp-gitlab@next`, um build de pré-lançamento que não é indicado para produção. O servidor exibe um aviso no stderr durante a inicialização quando existe uma versão mais nova disponível (desative com `GITLAB_DISABLE_VERSION_CHECK=true`).
|
|
256
256
|
|
|
257
257
|
#### Instalação com um clique no Claude Desktop (MCP Bundle)
|
|
258
258
|
|
package/README.zh-CN.md
CHANGED
|
@@ -252,7 +252,7 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
|
|
|
252
252
|
|
|
253
253
|
示例使用 `zereight-mcp-gitlab`,这是比旧的 `mcp-gitlab` 更不容易冲突的别名。如果 MCP 客户端找不到它,请使用 `which zereight-mcp-gitlab` 输出的绝对路径。
|
|
254
254
|
|
|
255
|
-
如果不想全局安装,请将 `npx` 固定到上一个稳定版本(即文档推荐的版本),例如 `npx -y @zereight/mcp-gitlab@2.3.
|
|
255
|
+
如果不想全局安装,请将 `npx` 固定到上一个稳定版本(即文档推荐的版本),例如 `npx -y @zereight/mcp-gitlab@2.3.19`。如果始终想使用最新版本,请改用 `npx -y @zereight/mcp-gitlab@latest`。如需在下一个稳定版本发布前试用已合并到 `main` 的修复,请使用 `npx -y @zereight/mcp-gitlab@next`(预发布版本,不适用于生产环境)。有新版本发布时,服务器会在启动时通过 stderr 提示(可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭)。
|
|
256
256
|
|
|
257
257
|
#### Claude Desktop 一键安装(MCP Bundle)
|
|
258
258
|
|
|
@@ -67,6 +67,9 @@ const LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS = new Set([
|
|
|
67
67
|
"list_webhooks", // url, event flags
|
|
68
68
|
"list_pipeline_triggers", // description
|
|
69
69
|
"list_job_artifacts", // path, type, size
|
|
70
|
+
"list_group_iterations", // start_date, due_date
|
|
71
|
+
"list_project_iterations", // start_date, due_date
|
|
72
|
+
"list_group_iteration_cadences", // start_date, duration_in_weeks, iterations_in_advance
|
|
70
73
|
// Small replies whose access fields are the point; summary: true keeps them (TOOL_SUMMARY_FIELDS).
|
|
71
74
|
"list_protected_branches", // *_access_levels, allow_force_push
|
|
72
75
|
"list_protected_tags", // create_access_levels
|
|
@@ -86,6 +89,7 @@ const LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS = new Set([
|
|
|
86
89
|
"list_group_variables", // environment_scope, variable_type
|
|
87
90
|
"list_merge_request_changed_files", // old_path, new_file/deleted_file/renamed_file
|
|
88
91
|
"list_work_items", // type, webUrl; assignees are strings, not users
|
|
92
|
+
"list_namespaces", // full_path, path, kind
|
|
89
93
|
]);
|
|
90
94
|
/**
|
|
91
95
|
* List tools that keep the full reply under GITLAB_MCP_LIST_SUMMARY_DEFAULT only
|
|
@@ -93,6 +97,77 @@ const LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS = new Set([
|
|
|
93
97
|
* the summary would drop.
|
|
94
98
|
*/
|
|
95
99
|
const CONTENT_ON_REQUEST_LIST_TOOLS = new Set(["list_wiki_pages", "list_group_wiki_pages"]);
|
|
100
|
+
/**
|
|
101
|
+
* List tools reviewed for GITLAB_MCP_LIST_SUMMARY_DEFAULT whose summary keeps what
|
|
102
|
+
* callers need, with the fields it must keep. Every list tool is in exactly one of
|
|
103
|
+
* this map, LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS, CONTENT_ON_REQUEST_LIST_TOOLS or
|
|
104
|
+
* NATIVE_SUMMARY_TOOLS: test/utils/list-summary-coverage.test.ts fails on a new
|
|
105
|
+
* list tool that is in none of them, or on a listed field the summary drops.
|
|
106
|
+
*/
|
|
107
|
+
export const LIST_SUMMARY_SAFE_TOOLS = {
|
|
108
|
+
list_issues: ["iid", "title", "state", "labels"],
|
|
109
|
+
list_issue_discussions: ["id", "notes"],
|
|
110
|
+
mr_discussions: ["id", "notes"],
|
|
111
|
+
list_merge_requests: ["iid", "title", "state", "source_branch", "target_branch", "draft"],
|
|
112
|
+
list_group_merge_requests: ["iid", "title", "state", "source_branch", "target_branch", "draft"],
|
|
113
|
+
list_deployment_merge_requests: ["iid", "title", "state", "source_branch", "target_branch"],
|
|
114
|
+
list_merge_request_pipelines: ["id", "status", "ref"],
|
|
115
|
+
list_pipelines: ["id", "status", "ref"],
|
|
116
|
+
list_pipeline_schedule_pipelines: ["id", "status", "ref"],
|
|
117
|
+
list_pipeline_schedules: ["id", "ref"],
|
|
118
|
+
list_pipeline_jobs: ["id", "name", "status"],
|
|
119
|
+
list_commit_statuses: ["id", "name", "status"],
|
|
120
|
+
list_deployments: ["id", "iid", "status", "ref"],
|
|
121
|
+
list_environments: ["id", "name", "state"],
|
|
122
|
+
list_commits: ["id", "short_id", "title"],
|
|
123
|
+
// Explicit (not a spread of TOOL_SUMMARY_FIELDS) so the coverage test guards that list.
|
|
124
|
+
list_branches: [
|
|
125
|
+
"name",
|
|
126
|
+
"protected",
|
|
127
|
+
"default",
|
|
128
|
+
"merged",
|
|
129
|
+
"can_push",
|
|
130
|
+
"developers_can_push",
|
|
131
|
+
"developers_can_merge",
|
|
132
|
+
],
|
|
133
|
+
list_tags: ["name"],
|
|
134
|
+
list_releases: ["name", "tag_name"],
|
|
135
|
+
list_milestones: ["id", "iid", "title", "state"],
|
|
136
|
+
list_group_milestones: ["id", "iid", "title", "state"],
|
|
137
|
+
list_labels: ["id", "name"],
|
|
138
|
+
list_projects: ["id", "path_with_namespace"],
|
|
139
|
+
list_group_projects: ["id", "path_with_namespace"],
|
|
140
|
+
list_snippets: ["id", "title", "web_url"],
|
|
141
|
+
list_project_runners: ["id", "status"],
|
|
142
|
+
list_merge_request_emoji_reactions: ["id", "name"],
|
|
143
|
+
list_merge_request_note_emoji_reactions: ["id", "name"],
|
|
144
|
+
list_issue_emoji_reactions: ["id", "name"],
|
|
145
|
+
list_issue_note_emoji_reactions: ["id", "name"],
|
|
146
|
+
list_work_item_emoji_reactions: ["id", "name"],
|
|
147
|
+
list_work_item_note_emoji_reactions: ["id", "name"],
|
|
148
|
+
};
|
|
149
|
+
/** Which of the lists above a summary-capable tool is in (test helper; no runtime effect). */
|
|
150
|
+
export function listSummaryClassifications(toolName) {
|
|
151
|
+
const found = [];
|
|
152
|
+
if (NATIVE_SUMMARY_TOOLS.has(toolName))
|
|
153
|
+
found.push("native");
|
|
154
|
+
if (LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS.has(toolName))
|
|
155
|
+
found.push("excluded");
|
|
156
|
+
if (CONTENT_ON_REQUEST_LIST_TOOLS.has(toolName))
|
|
157
|
+
found.push("content-on-request");
|
|
158
|
+
if (Object.hasOwn(LIST_SUMMARY_SAFE_TOOLS, toolName))
|
|
159
|
+
found.push("summary-safe");
|
|
160
|
+
return found.length > 0 ? found : ["unclassified"];
|
|
161
|
+
}
|
|
162
|
+
/** Every tool name the lists above mention (to catch stale entries). */
|
|
163
|
+
export function listSummaryClassifiedToolNames() {
|
|
164
|
+
return [
|
|
165
|
+
...NATIVE_SUMMARY_TOOLS,
|
|
166
|
+
...LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS,
|
|
167
|
+
...CONTENT_ON_REQUEST_LIST_TOOLS,
|
|
168
|
+
...Object.keys(LIST_SUMMARY_SAFE_TOOLS),
|
|
169
|
+
];
|
|
170
|
+
}
|
|
96
171
|
const CONTENT_REQUEST_ARGUMENTS = ["with_content", "render_html"];
|
|
97
172
|
/** Mirrors the boolean coercion of the tool schemas: true, 1, "true", "1". */
|
|
98
173
|
function isTruthyFlag(value) {
|
package/package.json
CHANGED