@zereight/mcp-gitlab 2.3.28-next.243 → 2.3.28-next.244
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 +5 -5
- package/README.md +6 -6
- package/README.pt-BR.md +5 -5
- package/README.zh-CN.md +5 -5
- package/build/index.js +2 -2
- package/build/schemas.js +1 -1
- package/build/tools/registry.js +1 -1
- package/build/tools/tool-descriptions.js +2 -0
- package/package.json +1 -1
package/README.ko.md
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
|
|
17
17
|
**기본 노출: 40개 도구** (`core` 38개 + `discover_tools` + `help`). 전체는 288개(toolset 285개 + `execute_graphql` + `discover_tools` + `help`). 작게 시작하고, 세션에서 `discover_tools`로 확장하세요.
|
|
18
18
|
|
|
19
|
-
> **토큰 예산:** MCP 클라이언트는 세션 시작 때 `tools/list` 전체를 모델에 보냅니다. 기본값(~40개 도구, 스키마 ~12k 토큰)을 유지하세요. 확장은 `discover_tools`로 이 세션에만 카테고리를 켜거나(`OAUTH_STATELESS_MODE=true`면 `GITLAB_TOOLSETS`로 남기세요), [Skill + CLI](./docs/getting-started/cli-without-mcp.md)로 MCP 스키마를 건너뛰세요. **`GITLAB_TOOLSETS=all`은 쓰지 마세요** — 거의 모든 도구를 올려 스키마만 ~73k 토큰입니다. [tools/list 크기](#toolslist-크기-2026-11-
|
|
19
|
+
> **토큰 예산:** MCP 클라이언트는 세션 시작 때 `tools/list` 전체를 모델에 보냅니다. 기본값(~40개 도구, 스키마 ~12k 토큰)을 유지하세요. 확장은 `discover_tools`로 이 세션에만 카테고리를 켜거나(`OAUTH_STATELESS_MODE=true`면 `GITLAB_TOOLSETS`로 남기세요), [Skill + CLI](./docs/getting-started/cli-without-mcp.md)로 MCP 스키마를 건너뛰세요. **`GITLAB_TOOLSETS=all`은 쓰지 마세요** — 거의 모든 도구를 올려 스키마만 ~73k 토큰입니다. [tools/list 크기](#toolslist-크기-2026-11-14-실측)와 [비교](./docs/comparison/index.md)를 보세요.
|
|
20
20
|
|
|
21
21
|
`zereight-mcp-gitlab` 바이너리를 먼저 설치하세요. `npm install -g @zereight/mcp-gitlab`, 또는 Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` 다음 `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. 공식 MCP Registry 항목: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). 한 줄 설치: `npx -y @zereight/mcp-gitlab@latest`.
|
|
22
22
|
|
|
@@ -167,15 +167,15 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
|
|
|
167
167
|
| **Node.js** | >=20.0.0 | 보통 >=24 | stdio는 `mcp-remote`, Node.js 20+ |
|
|
168
168
|
| **라이선스** | MIT | 서버마다 다름 | GitLab의 일부 |
|
|
169
169
|
|
|
170
|
-
### tools/list 크기 (2026-11-
|
|
170
|
+
### tools/list 크기 (2026-11-14 실측)
|
|
171
171
|
|
|
172
172
|
클라이언트는 세션 시작 때 `tools/list` 전체를 모델에 보냅니다. 토큰 추정은 UTF-8 바이트 / 4입니다.
|
|
173
173
|
|
|
174
174
|
| 프로필 | 도구 수 | JSON 바이트 | 추정 토큰 |
|
|
175
175
|
| ------ | ------: | ----------: | --------: |
|
|
176
|
-
| 기본값 (`core` + `discover_tools` + `help`) | 40 |
|
|
177
|
-
| `GITLAB_TOOL_PROFILE=slim` | 39 |
|
|
178
|
-
| `GITLAB_TOOLSETS=all` | 286 |
|
|
176
|
+
| 기본값 (`core` + `discover_tools` + `help`) | 40 | 47,822 | 11,956 |
|
|
177
|
+
| `GITLAB_TOOL_PROFILE=slim` | 39 | 46,814 | 11,704 |
|
|
178
|
+
| `GITLAB_TOOLSETS=all` | 286 | 295,933 | 73,984 |
|
|
179
179
|
|
|
180
180
|
설명이나 스키마를 바꾼 뒤에는 `npm run build && npm run test:mock` (`test/tools-list-budget.test.ts`)으로 다시 측정하세요.
|
|
181
181
|
|
package/README.md
CHANGED
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
**Default: 40 tools** (38 `core` + `discover_tools` + `help`). 288 tools exist in total (285 in toolsets + `execute_graphql` + `discover_tools` + `help`). Start lean; call `discover_tools` to activate more for this session.
|
|
23
23
|
|
|
24
|
-
> **Token budget:** MCP clients send the whole `tools/list` to the model at session start. Keep the default (~40 tools, ~12k schema tokens). Call `discover_tools` to activate a category for this session (session-only; with `OAUTH_STATELESS_MODE=true` persist a named `GITLAB_TOOLSETS` list), or use [Skill + CLI](./docs/getting-started/cli-without-mcp.md) and skip MCP schemas. **Do not set `GITLAB_TOOLSETS=all`** — it loads ~all tools and costs ~73k schema tokens. See [tools/list size](#toolslist-size-measured-2026-11-
|
|
24
|
+
> **Token budget:** MCP clients send the whole `tools/list` to the model at session start. Keep the default (~40 tools, ~12k schema tokens). Call `discover_tools` to activate a category for this session (session-only; with `OAUTH_STATELESS_MODE=true` persist a named `GITLAB_TOOLSETS` list), or use [Skill + CLI](./docs/getting-started/cli-without-mcp.md) and skip MCP schemas. **Do not set `GITLAB_TOOLSETS=all`** — it loads ~all tools and costs ~73k schema tokens. See [tools/list size](#toolslist-size-measured-2026-11-14) and [comparison](./docs/comparison/index.md).
|
|
25
25
|
|
|
26
26
|
Install the `zereight-mcp-gitlab` binary first with `npm install -g @zereight/mcp-gitlab`, or Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` and `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. Official MCP Registry listing: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). One-liner: `npx -y @zereight/mcp-gitlab@latest`.
|
|
27
27
|
|
|
@@ -172,15 +172,15 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
|
|
|
172
172
|
| **Node.js** | >=20.0.0 | Often >=24 | Node.js 20+ for stdio via `mcp-remote` |
|
|
173
173
|
| **License** | MIT | Varies | Part of GitLab |
|
|
174
174
|
|
|
175
|
-
### tools/list size (measured 2026-11-
|
|
175
|
+
### tools/list size (measured 2026-11-14)
|
|
176
176
|
|
|
177
177
|
A client sends the whole `tools/list` result to the model at session start. Token estimate is UTF-8 bytes / 4.
|
|
178
178
|
|
|
179
179
|
| Profile | Tools | JSON bytes | Est. tokens |
|
|
180
180
|
| ------- | ----: | ---------: | ----------: |
|
|
181
|
-
| Default (`core` + `discover_tools` + `help`) | 40 |
|
|
182
|
-
| `GITLAB_TOOL_PROFILE=slim` | 39 |
|
|
183
|
-
| `GITLAB_TOOLSETS=all` | 286 |
|
|
181
|
+
| Default (`core` + `discover_tools` + `help`) | 40 | 47,822 | 11,956 |
|
|
182
|
+
| `GITLAB_TOOL_PROFILE=slim` | 39 | 46,814 | 11,704 |
|
|
183
|
+
| `GITLAB_TOOLSETS=all` | 286 | 295,933 | 73,984 |
|
|
184
184
|
|
|
185
185
|
Re-measure with `npm run build && npm run test:mock` (`test/tools-list-budget.test.ts`) after description or schema changes.
|
|
186
186
|
|
|
@@ -804,7 +804,7 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
|
|
|
804
804
|
9. `search_repositories` - Search for GitLab projects
|
|
805
805
|
10. `create_repository` - Create a new GitLab project
|
|
806
806
|
11. `create_group` - Create new group or subgroup
|
|
807
|
-
12. `get_file_contents` - Get contents of
|
|
807
|
+
12. `get_file_contents` - Get the contents of one file from a GitLab project
|
|
808
808
|
13. `push_files` - Push multiple files in a single commit
|
|
809
809
|
14. `create_issue` - Create a new issue
|
|
810
810
|
15. `create_merge_request` - Create a new merge request
|
package/README.pt-BR.md
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
|
|
17
17
|
**Padrão: 40 ferramentas** (38 `core` + `discover_tools` + `help`). Existem 288 no total (285 em toolsets + `execute_graphql` + `discover_tools` + `help`). Comece enxuto; chame `discover_tools` para ativar mais nesta sessão.
|
|
18
18
|
|
|
19
|
-
> **Orçamento de tokens:** clientes MCP enviam o `tools/list` inteiro ao modelo no início da sessão. Mantenha o padrão (~40 ferramentas, ~12k tokens de schema). Chame `discover_tools` para ativar uma categoria nesta sessão (somente nesta sessão; com `OAUTH_STATELESS_MODE=true` persista uma lista `GITLAB_TOOLSETS`), ou use [Skill + CLI](./docs/getting-started/cli-without-mcp.md) e pule os schemas MCP. **Não defina `GITLAB_TOOLSETS=all`** — carrega quase todas as ferramentas e custa ~73k tokens de schema. Veja [tamanho do tools/list](#tamanho-do-toolslist-medido-em-2026-11-
|
|
19
|
+
> **Orçamento de tokens:** clientes MCP enviam o `tools/list` inteiro ao modelo no início da sessão. Mantenha o padrão (~40 ferramentas, ~12k tokens de schema). Chame `discover_tools` para ativar uma categoria nesta sessão (somente nesta sessão; com `OAUTH_STATELESS_MODE=true` persista uma lista `GITLAB_TOOLSETS`), ou use [Skill + CLI](./docs/getting-started/cli-without-mcp.md) e pule os schemas MCP. **Não defina `GITLAB_TOOLSETS=all`** — carrega quase todas as ferramentas e custa ~73k tokens de schema. Veja [tamanho do tools/list](#tamanho-do-toolslist-medido-em-2026-11-14) e [comparação](./docs/comparison/index.md).
|
|
20
20
|
|
|
21
21
|
Instale o binário `zereight-mcp-gitlab` antes. `npm install -g @zereight/mcp-gitlab`, ou Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` e `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. Listagem oficial no MCP Registry: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). Instalação em uma linha: `npx -y @zereight/mcp-gitlab@latest`.
|
|
22
22
|
|
|
@@ -167,15 +167,15 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinâmicas e autorização
|
|
|
167
167
|
| **Node.js** | >=20.0.0 | Frequentemente >=24 | Node.js 20+ para stdio via `mcp-remote` |
|
|
168
168
|
| **Licença** | MIT | Varia | Parte do GitLab |
|
|
169
169
|
|
|
170
|
-
### Tamanho do tools/list (medido em 2026-11-
|
|
170
|
+
### Tamanho do tools/list (medido em 2026-11-14)
|
|
171
171
|
|
|
172
172
|
O cliente envia o `tools/list` inteiro ao modelo no início da sessão. A estimativa de tokens é bytes UTF-8 / 4.
|
|
173
173
|
|
|
174
174
|
| Perfil | Ferramentas | Bytes JSON | Tokens estimados |
|
|
175
175
|
| ------ | ----------: | ---------: | ---------------: |
|
|
176
|
-
| Padrão (`core` + `discover_tools` + `help`) | 40 |
|
|
177
|
-
| `GITLAB_TOOL_PROFILE=slim` | 39 |
|
|
178
|
-
| `GITLAB_TOOLSETS=all` | 286 |
|
|
176
|
+
| Padrão (`core` + `discover_tools` + `help`) | 40 | 47.822 | 11.956 |
|
|
177
|
+
| `GITLAB_TOOL_PROFILE=slim` | 39 | 46.814 | 11.704 |
|
|
178
|
+
| `GITLAB_TOOLSETS=all` | 286 | 295.933 | 73.984 |
|
|
179
179
|
|
|
180
180
|
Após alterar descrições ou schemas, meça de novo com `npm run build && npm run test:mock` (`test/tools-list-budget.test.ts`).
|
|
181
181
|
|
package/README.zh-CN.md
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
|
|
17
17
|
**默认暴露 40 个工具**(38 个 `core` + `discover_tools` + `help`)。总共 288 个(toolset 中 285 个 + `execute_graphql` + `discover_tools` + `help`)。先用精简集,再在本会话中用 `discover_tools` 扩展。
|
|
18
18
|
|
|
19
|
-
> **Token 预算:** MCP 客户端会在会话开始时把整份 `tools/list` 发给模型。请保持默认(约 40 个工具,约 12k schema token)。用 `discover_tools` 为本会话激活类别(仅限本会话;`OAUTH_STATELESS_MODE=true` 时请改用命名的 `GITLAB_TOOLSETS`),或走 [Skill + CLI](./docs/getting-started/cli-without-mcp.md) 以跳过 MCP schema。**不要设置 `GITLAB_TOOLSETS=all`** — 它会加载几乎全部工具,schema 约 73k token。见 [tools/list 体积](#toolslist-体积2026-11-
|
|
19
|
+
> **Token 预算:** MCP 客户端会在会话开始时把整份 `tools/list` 发给模型。请保持默认(约 40 个工具,约 12k schema token)。用 `discover_tools` 为本会话激活类别(仅限本会话;`OAUTH_STATELESS_MODE=true` 时请改用命名的 `GITLAB_TOOLSETS`),或走 [Skill + CLI](./docs/getting-started/cli-without-mcp.md) 以跳过 MCP schema。**不要设置 `GITLAB_TOOLSETS=all`** — 它会加载几乎全部工具,schema 约 73k token。见 [tools/list 体积](#toolslist-体积2026-11-14-实测) 和 [对比](./docs/comparison/index.md)。
|
|
20
20
|
|
|
21
21
|
先安装 `zereight-mcp-gitlab` 二进制。`npm install -g @zereight/mcp-gitlab`,或 Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` 然后 `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`。官方 MCP Registry 条目:[`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp)。一键安装:`npx -y @zereight/mcp-gitlab@latest`。
|
|
22
22
|
|
|
@@ -167,15 +167,15 @@ GitLab 合并请求、议题和流水线走此 MCP(@zereight/mcp-gitlab)。
|
|
|
167
167
|
| **Node.js** | >=20.0.0 | 通常 >=24 | stdio 经 `mcp-remote`,需要 Node.js 20+ |
|
|
168
168
|
| **许可证** | MIT | 因服务器而异 | GitLab 的一部分 |
|
|
169
169
|
|
|
170
|
-
### tools/list 体积(2026-11-
|
|
170
|
+
### tools/list 体积(2026-11-14 实测)
|
|
171
171
|
|
|
172
172
|
客户端会在会话开始时把整份 `tools/list` 发给模型。Token 估算为 UTF-8 字节 / 4。
|
|
173
173
|
|
|
174
174
|
| 配置 | 工具数 | JSON 字节 | 估算 token |
|
|
175
175
|
| ---- | -----: | --------: | ---------: |
|
|
176
|
-
| 默认(`core` + `discover_tools` + `help`) | 40 |
|
|
177
|
-
| `GITLAB_TOOL_PROFILE=slim` | 39 |
|
|
178
|
-
| `GITLAB_TOOLSETS=all` | 286 |
|
|
176
|
+
| 默认(`core` + `discover_tools` + `help`) | 40 | 47,822 | 11,956 |
|
|
177
|
+
| `GITLAB_TOOL_PROFILE=slim` | 39 | 46,814 | 11,704 |
|
|
178
|
+
| `GITLAB_TOOLSETS=all` | 286 | 295,933 | 73,984 |
|
|
179
179
|
|
|
180
180
|
更改描述或 schema 后,用 `npm run build && npm run test:mock`(`test/tools-list-budget.test.ts`)重新测量。
|
|
181
181
|
|
package/build/index.js
CHANGED
|
@@ -1588,9 +1588,9 @@ async function getFileContents(projectId, filePath, ref) {
|
|
|
1588
1588
|
const response = await fetch(url.toString(), {
|
|
1589
1589
|
...getFetchConfig(),
|
|
1590
1590
|
});
|
|
1591
|
-
// Handle file not found
|
|
1591
|
+
// Handle file not found (the Files API also answers 404 for a directory or an unknown ref)
|
|
1592
1592
|
if (response.status === 404) {
|
|
1593
|
-
throw new GitLabApiError(`File not found: ${filePath}`, response);
|
|
1593
|
+
throw new GitLabApiError(withRecoveryHint(`File not found: ${filePath}`, "check file_path and ref; to list a directory, use get_repository_tree."), response);
|
|
1594
1594
|
}
|
|
1595
1595
|
await handleGitLabError(response);
|
|
1596
1596
|
const data = await response.json();
|
package/build/schemas.js
CHANGED
|
@@ -1904,7 +1904,7 @@ export const GetFileContentsSchema = z
|
|
|
1904
1904
|
file_path: z
|
|
1905
1905
|
.string()
|
|
1906
1906
|
.optional()
|
|
1907
|
-
.describe("Path to the file
|
|
1907
|
+
.describe("Path to the file (not a directory). Takes precedence over 'path' when both are provided"),
|
|
1908
1908
|
path: z.string().optional().describe("Alias of file_path"),
|
|
1909
1909
|
ref: z.string().optional().describe("Branch/tag/commit to get contents from"),
|
|
1910
1910
|
})
|
package/build/tools/registry.js
CHANGED
|
@@ -64,7 +64,7 @@ export const allTools = withLazyInputSchemas([
|
|
|
64
64
|
},
|
|
65
65
|
{
|
|
66
66
|
name: "get_file_contents",
|
|
67
|
-
description: "Get contents of
|
|
67
|
+
description: "Get the contents of one file from a GitLab project",
|
|
68
68
|
inputSchema: lazyJSONSchema(GetFileContentsSchema),
|
|
69
69
|
},
|
|
70
70
|
{
|
|
@@ -6,6 +6,8 @@ const TOOL_GUIDANCE = {
|
|
|
6
6
|
get_merge_request_approval_state: "Inspect approval rules and approvers before merging. Use `approve_merge_request` to change approval state.",
|
|
7
7
|
get_merge_request_conflicts: "Inspect merge conflicts before `merge_merge_request`. It reports conflicts and does not resolve them.",
|
|
8
8
|
list_merge_request_pipelines: "List pipelines for one merge request. Use `list_pipelines` for project-wide filtering.",
|
|
9
|
+
get_file_contents: "`ref` defaults to the default branch. `encoding` is `utf8` when a UTF-8 round-trip test passes, else `base64`; binaries with valid UTF-8 bytes (e.g. 0x00) also pass. Read `encoding`, don't infer it. Directories are not supported: use `get_repository_tree`.",
|
|
10
|
+
get_repository_tree: "One level under `path` unless `recursive` is true. Use `get_file_contents` to read a file.",
|
|
9
11
|
create_or_update_file: "Create or update one repository file. Use `push_files` for a multi-file commit. Optional `encoding` (`text` or `base64`) defaults to `GITLAB_REPO_FILE_ENCODING`.",
|
|
10
12
|
push_files: "Commit several file changes atomically. Each file defaults to action `create`; optional per-file `action` (create/update/delete/move) and `encoding` (text/base64) are additive. `GITLAB_PERMISSION_MODE=modify` rejects `delete` and `move`.",
|
|
11
13
|
create_issue: "Open a new issue. Use `update_issue` for an existing issue and `create_issue_note` for discussion.",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zereight/mcp-gitlab",
|
|
3
|
-
"version": "2.3.28-next.
|
|
3
|
+
"version": "2.3.28-next.244",
|
|
4
4
|
"mcpName": "io.github.zereight/gitlab-mcp",
|
|
5
5
|
"description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
|
|
6
6
|
"keywords": [
|