@zereight/mcp-gitlab 2.0.3 → 2.0.4

package/README.md

@@ -1,4 +1,6 @@
-# Better GitLab MCP Server
+# GitLab MCP Server
+
+[![Star History Chart](https://api.star-history.com/svg?repos=zereight/gitlab-mcp&type=Date)](https://www.star-history.com/#zereight/gitlab-mcp&Date)
 
 ## @zereight/mcp-gitlab
 
@@ -10,7 +12,7 @@ GitLab MCP(Model Context Protocol) Server. **Includes bug fixes and improvements
 
 ## Usage
 
-### Using with Claude App, Cline, Roo Code, Cursor
+### Using with Claude App, Cline, Roo Code, Cursor, Kilo Code
 
 When using with the Claude App, you need to set up your API key and URLs directly.
 
@@ -19,7 +21,7 @@ When using with the Claude App, you need to set up your API key and URLs directl
 ```json
 {
   "mcpServers": {
-    "GitLab communication server": {
+    "gitlab": {
       "command": "npx",
       "args": ["-y", "@zereight/mcp-gitlab"],
       "env": {
@@ -72,7 +74,7 @@ When using with the Claude App, you need to set up your API key and URLs directl
 ```json
 {
   "mcpServers": {
-    "GitLab communication server": {
+    "gitlab": {
       "command": "docker",
       "args": [
         "run",
@@ -110,7 +112,7 @@ When using with the Claude App, you need to set up your API key and URLs directl
 ```shell
 docker run -i --rm \
   -e GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token \
-  -e GITLAB_API_URL= "https://gitlab.com/api/v4"\
+  -e GITLAB_API_URL="https://gitlab.com/api/v4" \
   -e GITLAB_READ_ONLY_MODE=true \
   -e USE_GITLAB_WIKI=true \
   -e USE_MILESTONE=true \
@@ -123,7 +125,7 @@ docker run -i --rm \
 ```json
 {
   "mcpServers": {
-    "GitLab communication server": {
+    "gitlab": {
       "type": "sse",
       "url": "http://localhost:3333/sse"
     }
@@ -131,10 +133,8 @@ docker run -i --rm \
 }
 ```
 
-
 - streamable-http
 
-
 ```shell
 docker run -i --rm \
   -e GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token \
@@ -151,20 +151,14 @@ docker run -i --rm \
 ```json
 {
   "mcpServers": {
-    "GitLab communication server": {
+    "gitlab": {
+      "type": "streamable-http",
       "url": "http://localhost:3333/mcp"
     }
   }
 }
 ```
 
-
-#### Docker Image Push
-
-```shell
-$ sh scripts/image_push.sh docker_user_name
-```
-
 ### Environment Variables
 
 - `GITLAB_PERSONAL_ACCESS_TOKEN`: Your GitLab personal access token.
@@ -174,6 +168,7 @@ $ sh scripts/image_push.sh docker_user_name
   - Single value `123`: MCP server can only access project 123 and uses it as default
   - Multiple values `123,456,789`: MCP server can access projects 123, 456, and 789 but requires explicit project ID in requests
 - `GITLAB_READ_ONLY_MODE`: When set to 'true', restricts the server to only expose read-only operations. Useful for enhanced security or when write access is not needed. Also useful for using with Cursor and it's 40 tool limit.
+- `GITLAB_DENIED_TOOLS_REGEX`: When set as a regular expression, it excludes the matching tools.
 - `USE_GITLAB_WIKI`: When set to 'true', enables the wiki-related tools (list_wiki_pages, get_wiki_page, create_wiki_page, update_wiki_page, delete_wiki_page). By default, wiki features are disabled.
 - `USE_MILESTONE`: When set to 'true', enables the milestone-related tools (list_milestones, get_milestone, create_milestone, edit_milestone, delete_milestone, get_milestone_issue, get_milestone_merge_requests, promote_milestone, get_milestone_burndown_events). By default, milestone features are disabled.
 - `USE_PIPELINE`: When set to 'true', enables the pipeline-related tools (list_pipelines, get_pipeline, list_pipeline_jobs, get_pipeline_job, get_pipeline_job_output, create_pipeline, retry_pipeline, cancel_pipeline). By default, pipeline features are disabled.
@@ -181,11 +176,13 @@ $ sh scripts/image_push.sh docker_user_name
 - `SSE`: When set to 'true', enables the Server-Sent Events transport.
 - `STREAMABLE_HTTP`: When set to 'true', enables the Streamable HTTP transport. If both **SSE** and **STREAMABLE_HTTP** are set to 'true', the server will prioritize Streamable HTTP over SSE transport.
 
-[![Star History Chart](https://api.star-history.com/svg?repos=zereight/gitlab-mcp&type=Date)](https://www.star-history.com/#zereight/gitlab-mcp&Date)
-
 ## Tools 🛠️
 
-+<!-- TOOLS-START -->
+<details>
+<summary>Click to expand</summary>
+
+<!-- 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
@@ -270,3 +267,5 @@ $ sh scripts/image_push.sh docker_user_name
 82. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
 83. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
 <!-- TOOLS-END -->
+
+</details>

package/build/index.js

@@ -80,6 +80,7 @@ const GITLAB_PERSONAL_ACCESS_TOKEN = process.env.GITLAB_PERSONAL_ACCESS_TOKEN;
 const GITLAB_AUTH_COOKIE_PATH = process.env.GITLAB_AUTH_COOKIE_PATH;
 const IS_OLD = process.env.GITLAB_IS_OLD === "true";
 const GITLAB_READ_ONLY_MODE = process.env.GITLAB_READ_ONLY_MODE === "true";
+const GITLAB_DENIED_TOOLS_REGEX = process.env.GITLAB_DENIED_TOOLS_REGEX ? new RegExp(process.env.GITLAB_DENIED_TOOLS_REGEX) : undefined;
 const USE_GITLAB_WIKI = process.env.USE_GITLAB_WIKI === "true";
 const USE_MILESTONE = process.env.USE_MILESTONE === "true";
 const USE_PIPELINE = process.env.USE_PIPELINE === "true";
@@ -3113,6 +3114,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         : tools1.filter(tool => !milestoneToolNames.includes(tool.name));
     // Toggle pipeline tools by USE_PIPELINE flag
     let tools = USE_PIPELINE ? tools2 : tools2.filter(tool => !pipelineToolNames.includes(tool.name));
+    tools = GITLAB_DENIED_TOOLS_REGEX ? tools.filter(tool => !GITLAB_DENIED_TOOLS_REGEX.test(tool.name)) : tools;
     // <<< START: Gemini 호환성을 위해 $schema 제거 >>>
     tools = tools.map(tool => {
         // inputSchema가 존재하고 객체인지 확인

package/build/schemas.js

@@ -20,7 +20,7 @@ export const GitLabPipelineSchema = z.object({
     duration: z.number().nullable().optional(),
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
-    coverage: z.number().nullable().optional(),
+    coverage: z.coerce.number().nullable().optional(),
     user: z
         .object({
         id: z.coerce.string(),
@@ -58,7 +58,7 @@ export const GitLabPipelineJobSchema = z.object({
     name: z.string(),
     ref: z.string(),
     tag: flexibleBoolean,
-    coverage: z.number().nullable().optional(),
+    coverage: z.coerce.number().nullable().optional(),
     created_at: z.string(),
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",
@@ -21,7 +21,6 @@
     "dev": "npm run build && node build/index.js",
     "watch": "tsc --watch",
     "deploy": "npm publish --access public",
-    "generate-tools": "npx ts-node scripts/generate-tools-readme.ts",
     "changelog": "auto-changelog -p",
     "test": "node test/validate-api.js",
     "test:integration": "node test/validate-api.js",

package/build/scripts/generate-tools-readme.js

@@ -1,41 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-async function main() {
-    const repoRoot = path.resolve(__dirname, "..");
-    const indexPath = path.join(repoRoot, "index.ts");
-    const readmePath = path.join(repoRoot, "README.md");
-    // 1. Read index.ts
-    const code = fs.readFileSync(indexPath, "utf-8");
-    // 2. Extract allTools array block
-    const match = code.match(/const allTools = \[([\s\S]*?)\];/);
-    if (!match) {
-        console.error("Unable to locate allTools array in index.ts");
-        process.exit(1);
-    }
-    const toolsBlock = match[1];
-    // 3. Parse tool entries
-    const toolRegex = /name:\s*"([^"]+)",[\s\S]*?description:\s*"([^"]+)"/g;
-    const tools = [];
-    let m;
-    while ((m = toolRegex.exec(toolsBlock)) !== null) {
-        tools.push({ name: m[1], description: m[2] });
-    }
-    // 4. Generate markdown
-    const lines = tools.map((tool, index) => {
-        return `${index + 1}. \`${tool.name}\` - ${tool.description}`;
-    });
-    const markdown = lines.join("\n");
-    // 5. Read README.md and replace between markers
-    const readme = fs.readFileSync(readmePath, "utf-8");
-    const updated = readme.replace(/<!-- TOOLS-START -->([\s\S]*?)<!-- TOOLS-END -->/, `<!-- TOOLS-START -->\n${markdown}\n<!-- TOOLS-END -->`);
-    // 6. Write back
-    fs.writeFileSync(readmePath, updated, "utf-8");
-    console.log("README.md tools section updated.");
-}
-main().catch(err => {
-    console.error(err);
-    process.exit(1);
-});