gitlab-duo-mcp-bridge 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DataTalesByAgos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,10 @@
 # gitlab-duo-mcp-bridge
 
+[![npm version](https://img.shields.io/npm/v/gitlab-duo-mcp-bridge.svg)](https://www.npmjs.com/package/gitlab-duo-mcp-bridge)
+[![npm downloads](https://img.shields.io/npm/dm/gitlab-duo-mcp-bridge.svg)](https://www.npmjs.com/package/gitlab-duo-mcp-bridge)
+[![license](https://img.shields.io/npm/l/gitlab-duo-mcp-bridge.svg)](./LICENSE)
+[![node](https://img.shields.io/node/v/gitlab-duo-mcp-bridge.svg)](https://nodejs.org)
+
 A tiny **MCP server** that wraps the **GitLab Duo CLI** as a single, clean,
 fault-tolerant tool: **`duo_review`**.
 
@@ -69,9 +74,30 @@ result back as clean JSON. You don't copy code around — Duo gathers it itself.
 
 ## Quick start (plug and play)
 
-No clone, no build, no paths to figure out. Add one line to your MCP client and
-`npx` downloads and runs the bridge automatically the first time your agent
-calls it.
+No clone, no build, no paths to figure out. You can configure your environment automatically with a single command, or add it manually.
+
+### 1. Automatic installation (Recommended)
+
+Run the automatic configurator from your terminal:
+
+```bash
+npx gitlab-duo-mcp-bridge setup
+```
+
+This script will automatically detect and configure all active MCP clients on your system:
+- **Claude Desktop** (both standard and Windows Microsoft Store packages)
+- **Cursor**
+- **Cline** (VS Code)
+- **Roo Code / Roo Cline** (VS Code)
+- **Windsurf**
+- **Zed**
+- **Continue**
+
+Once run, simply restart or reload your editor/agent.
+
+---
+
+### 2. Manual configuration
 
 **Claude Code:**
 

package/dist/src/index.js

@@ -8,7 +8,12 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { loadConfig } from "./config.js";
 import { createServer } from "./server.js";
+import { runSetup } from "./setup.js";
 async function main() {
+    if (process.argv[2] === "setup") {
+        await runSetup();
+        return;
+    }
     const config = loadConfig();
     const server = createServer(config);
     const transport = new StdioServerTransport();

package/dist/src/setup.js

@@ -0,0 +1,209 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+export async function runSetup() {
+    const home = os.homedir();
+    const platform = os.platform();
+    const appData = process.env.APPDATA || "";
+    const localAppData = process.env.LOCALAPPDATA || "";
+    // Define client configurations and their paths
+    const targets = [];
+    const newConfigEntry = {
+        command: "npx",
+        args: ["-y", "gitlab-duo-mcp-bridge"],
+    };
+    if (platform === "win32") {
+        // Claude Desktop (Standard)
+        if (appData) {
+            targets.push({
+                name: "Claude Desktop (Standard)",
+                path: path.join(appData, "Claude", "claude_desktop_config.json"),
+                key: "mcpServers",
+            });
+        }
+        // Claude Desktop (MSIX)
+        if (localAppData) {
+            targets.push({
+                name: "Claude Desktop (MSIX)",
+                path: path.join(localAppData, "Packages", "Claude_pzs8sxrjxfjjc", "LocalCache", "Roaming", "Claude", "claude_desktop_config.json"),
+                key: "mcpServers",
+            });
+        }
+        // Cursor
+        targets.push({
+            name: "Cursor",
+            path: path.join(home, ".cursor", "mcp.json"),
+            key: "mcpServers",
+        });
+        // Cline
+        if (appData) {
+            targets.push({
+                name: "Cline (VS Code)",
+                path: path.join(appData, "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
+                key: "mcpServers",
+            });
+        }
+        // Roo Code
+        if (appData) {
+            targets.push({
+                name: "Roo Code (VS Code)",
+                path: path.join(appData, "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "cline_mcp_settings.json"),
+                key: "mcpServers",
+            });
+        }
+        // Windsurf
+        if (appData) {
+            targets.push({
+                name: "Windsurf",
+                path: path.join(appData, "Windsurf", "mcp_settings.json"),
+                key: "mcpServers",
+            });
+        }
+    }
+    else if (platform === "darwin") {
+        // Claude Desktop
+        targets.push({
+            name: "Claude Desktop",
+            path: path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+            key: "mcpServers",
+        });
+        // Cursor
+        targets.push({
+            name: "Cursor",
+            path: path.join(home, ".cursor", "mcp.json"),
+            key: "mcpServers",
+        });
+        // Cline
+        targets.push({
+            name: "Cline (VS Code)",
+            path: path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
+            key: "mcpServers",
+        });
+        // Roo Code
+        targets.push({
+            name: "Roo Code (VS Code)",
+            path: path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "cline_mcp_settings.json"),
+            key: "mcpServers",
+        });
+        // Windsurf
+        targets.push({
+            name: "Windsurf",
+            path: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
+            key: "mcpServers",
+        });
+        // Zed
+        targets.push({
+            name: "Zed",
+            path: path.join(home, ".config", "zed", "settings.json"),
+            key: "context_servers",
+        });
+    }
+    else {
+        // Linux and others
+        // Claude Desktop
+        targets.push({
+            name: "Claude Desktop",
+            path: path.join(home, ".config", "Claude", "claude_desktop_config.json"),
+            key: "mcpServers",
+        });
+        // Cursor
+        targets.push({
+            name: "Cursor",
+            path: path.join(home, ".cursor", "mcp.json"),
+            key: "mcpServers",
+        });
+        // Cline
+        targets.push({
+            name: "Cline (VS Code)",
+            path: path.join(home, ".config", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
+            key: "mcpServers",
+        });
+        // Roo Code
+        targets.push({
+            name: "Roo Code (VS Code)",
+            path: path.join(home, ".config", "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "cline_mcp_settings.json"),
+            key: "mcpServers",
+        });
+        // Windsurf
+        targets.push({
+            name: "Windsurf",
+            path: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
+            key: "mcpServers",
+        });
+        // Zed
+        targets.push({
+            name: "Zed",
+            path: path.join(home, ".config", "zed", "settings.json"),
+            key: "context_servers",
+        });
+    }
+    // Continue-specific path (Always uses a dedicated JSON file under ~/.continue/mcpServers/)
+    targets.push({
+        name: "Continue (IDE)",
+        path: path.join(home, ".continue", "mcpServers", "gitlab-duo.json"),
+        key: "raw",
+    });
+    process.stderr.write("Iniciando la configuración automática de gitlab-duo-mcp-bridge...\n\n");
+    let configuredCount = 0;
+    for (const target of targets) {
+        const parentDir = path.dirname(target.path);
+        try {
+            // Check if parent directory exists
+            await fs.access(parentDir);
+        }
+        catch {
+            // Parent directory does not exist, so client is likely not installed or used. Skip it.
+            continue;
+        }
+        try {
+            let config = {};
+            if (target.key === "raw") {
+                // For dedicated JSON files (like Continue's config files under ~/.continue/mcpServers/)
+                // We write the standard structure directly.
+                config = {
+                    mcpServers: {
+                        "gitlab-duo": newConfigEntry,
+                    },
+                };
+            }
+            else {
+                try {
+                    const content = await fs.readFile(target.path, "utf8");
+                    // Handle empty or whitespace files safely
+                    if (content.trim() !== "") {
+                        config = JSON.parse(content);
+                    }
+                }
+                catch (err) {
+                    if (err.code !== "ENOENT") {
+                        process.stderr.write(`⚠️ No se pudo leer o parsear ${target.name} en ${target.path}: ${err.message}\n`);
+                        continue;
+                    }
+                }
+                const key = target.key;
+                if (!config[key]) {
+                    config[key] = {};
+                }
+                config[key]["gitlab-duo"] = newConfigEntry;
+            }
+            // Ensure directory exists (just in case)
+            await fs.mkdir(parentDir, { recursive: true });
+            // Write config back
+            await fs.writeFile(target.path, JSON.stringify(config, null, 2), "utf8");
+            process.stderr.write(`✅ Configurado con éxito: ${target.name}\n   └─ Ruta: ${target.path}\n`);
+            configuredCount++;
+        }
+        catch (err) {
+            process.stderr.write(`❌ Error al configurar ${target.name} en ${target.path}: ${err.message}\n`);
+        }
+    }
+    process.stderr.write("\n");
+    if (configuredCount > 0) {
+        process.stderr.write(`🎉 ¡Configuración completa! Se configuraron ${configuredCount} cliente(s) MCP.\n`);
+        process.stderr.write("Recuerda reiniciar o recargar tu cliente de IA para que detecte la herramienta 'duo_review'.\n");
+    }
+    else {
+        process.stderr.write("⚠️ No se encontraron directorios de configuración de clientes MCP activos.\n");
+        process.stderr.write("Si usas Claude Desktop, Cursor, Cline, Roo Code, Windsurf, Zed o Continue, asegúrate de haberlos instalado e iniciado al menos una vez.\n");
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitlab-duo-mcp-bridge",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server that wraps the GitLab Duo CLI as a clean, fault-tolerant duo_review tool for AI coding agents.",
   "type": "module",
   "bin": {
@@ -9,6 +9,7 @@
   "files": [
     "dist/src",
     "README.md",
+    "LICENSE",
     ".env.example"
   ],
   "engines": {
@@ -33,6 +34,14 @@
     "ai-agents"
   ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DataTalesByAgos/gitlab-duo-mcp-bridge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DataTalesByAgos/gitlab-duo-mcp-bridge/issues"
+  },
+  "homepage": "https://github.com/DataTalesByAgos/gitlab-duo-mcp-bridge#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.0"