gitlab-duo-mcp-bridge 0.1.0 → 0.3.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/config.js

@@ -30,13 +30,28 @@ function isTruthy(value) {
         return false;
     return ["1", "true", "yes", "on"].includes(value.trim().toLowerCase());
 }
+export function resolveModel(model) {
+    if (!model)
+        return undefined;
+    const MODEL_MAPPING = {
+        sonnet: "claude_sonnet_4_6",
+        haiku: "claude_haiku_4_5_20251001",
+        opus: "claude_opus_4_5_20251101",
+        "gpt5-codex": "gpt_5_codex",
+        gpt5: "gpt_5",
+        "gpt5-mini": "gpt_5_mini",
+        gemini: "gemini_2_5_flash_vertex",
+    };
+    const key = model.trim().toLowerCase();
+    return MODEL_MAPPING[key] ?? model;
+}
 export function loadConfig(env = process.env) {
     return {
         command: trimmedOrUndefined(env.DUO_CLI_COMMAND) ?? "glab",
         baseArgs: splitArgs(env.DUO_CLI_BASE_ARGS, ["duo", "cli", "run"]),
         goalFlag: trimmedOrUndefined(env.DUO_CLI_GOAL_FLAG) ?? "--goal",
         modelFlag: trimmedOrUndefined(env.DUO_CLI_MODEL_FLAG) ?? "--model",
-        model: trimmedOrUndefined(env.GITLAB_DUO_MODEL),
+        model: resolveModel(trimmedOrUndefined(env.GITLAB_DUO_MODEL)),
         extraArgs: splitArgs(env.DUO_CLI_EXTRA_ARGS, []),
         timeoutMs: parseIntOr(env.DUO_TIMEOUT_MS, 120_000),
         cwd: trimmedOrUndefined(env.DUO_CLI_CWD),

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/server.js

@@ -4,6 +4,7 @@
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
+import { resolveModel } from "./config.js";
 import { buildReviewGoal } from "./goal.js";
 import { runDuo } from "./duoRunner.js";
 import { buildPointerGoal, writeGoalFile, } from "./goalFile.js";
@@ -119,7 +120,7 @@ export async function handleReview(config, input) {
                 baseArgs: config.baseArgs,
                 goalFlag: config.goalFlag,
                 modelFlag: config.modelFlag,
-                model: input.model ?? config.model,
+                model: resolveModel(input.model) ?? config.model,
                 extraArgs: config.extraArgs,
                 timeoutMs: input.timeoutMs ?? config.timeoutMs,
                 cwd: effectiveCwd,

package/dist/src/setup.js

@@ -0,0 +1,354 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+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("Starting setup of gitlab-duo-mcp-bridge...\n\n");
+    const rl = readline.createInterface({ input, output });
+    process.stderr.write("Where would you like to configure gitlab-duo-mcp-bridge?\n");
+    process.stderr.write("  1. Globally (system-wide for detected IDEs & MCP clients)\n");
+    process.stderr.write("  2. Locally (in the current project directory)\n\n");
+    let choice = "1";
+    try {
+        const choiceAnswer = await rl.question("Enter choice (1 or 2) [1]: ");
+        if (choiceAnswer.trim() === "2" || choiceAnswer.trim().toLowerCase() === "locally") {
+            choice = "2";
+        }
+    }
+    catch (err) {
+        // Gracefully fallback to choice "1" on any error
+    }
+    if (choice === "2") {
+        rl.close();
+        process.stderr.write("\nConfiguring locally in the current project directory...\n\n");
+        const localPath = path.join(process.cwd(), "mcp.json");
+        try {
+            let config = {};
+            try {
+                const content = await fs.readFile(localPath, "utf8");
+                if (content.trim() !== "") {
+                    config = JSON.parse(content);
+                }
+            }
+            catch (err) {
+                if (err.code !== "ENOENT") {
+                    process.stderr.write(`⚠️ Could not read or parse existing mcp.json at ${localPath}: ${err.message}\n`);
+                }
+            }
+            if (!config.mcpServers) {
+                config.mcpServers = {};
+            }
+            config.mcpServers["gitlab-duo"] = newConfigEntry;
+            await fs.writeFile(localPath, JSON.stringify(config, null, 2), "utf8");
+            process.stderr.write(`✅ Successfully configured locally: mcp.json\n   └─ Path: ${localPath}\n\n`);
+            process.stderr.write("🎉 Configuration complete!\n");
+            process.stderr.write("Remember to restart or reload your AI client/agent to detect the 'duo_review' tool.\n");
+            await checkGitLabConnection();
+            printMiniGuide();
+        }
+        catch (err) {
+            process.stderr.write(`❌ Error configuring locally at ${localPath}: ${err.message}\n`);
+        }
+        return;
+    }
+    process.stderr.write("\nScanning for active MCP client configuration directories...\n\n");
+    const detectedTargets = [];
+    for (const target of targets) {
+        const parentDir = path.dirname(target.path);
+        try {
+            await fs.access(parentDir);
+            detectedTargets.push(target);
+        }
+        catch {
+            // Parent directory does not exist, so client is likely not installed or used. Skip it.
+        }
+    }
+    if (detectedTargets.length === 0) {
+        rl.close();
+        process.stderr.write("⚠️ No active MCP client configuration directories were found.\n");
+        process.stderr.write("If you use Claude Desktop, Cursor, Cline, Roo Code, Windsurf, Zed, or Continue, please make sure they are installed and have been opened at least once.\n");
+        return;
+    }
+    process.stderr.write("We detected the following MCP client(s):\n");
+    detectedTargets.forEach((target, index) => {
+        process.stderr.write(`  ${index + 1}. ${target.name}\n`);
+    });
+    process.stderr.write("\n");
+    let selectedTargets = detectedTargets;
+    try {
+        const answer = await rl.question("Do you want to configure all detected clients? (Y/n): ");
+        const parsedAnswer = answer.trim().toLowerCase();
+        if (parsedAnswer !== "" && parsedAnswer !== "y" && parsedAnswer !== "yes") {
+            selectedTargets = [];
+            for (const target of detectedTargets) {
+                const individualAnswer = await rl.question(`Configure ${target.name}? (y/N): `);
+                if (individualAnswer.trim().toLowerCase().startsWith("y")) {
+                    selectedTargets.push(target);
+                }
+            }
+        }
+    }
+    finally {
+        rl.close();
+    }
+    if (selectedTargets.length === 0) {
+        process.stderr.write("\n⚠️ No clients were selected for configuration.\n");
+        return;
+    }
+    process.stderr.write("\n");
+    let configuredCount = 0;
+    for (const target of selectedTargets) {
+        const parentDir = path.dirname(target.path);
+        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(`⚠️ Could not read or parse ${target.name} at ${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(`✅ Successfully configured: ${target.name}\n   └─ Path: ${target.path}\n`);
+            configuredCount++;
+        }
+        catch (err) {
+            process.stderr.write(`❌ Error configuring ${target.name} at ${target.path}: ${err.message}\n`);
+        }
+    }
+    process.stderr.write("\n");
+    if (configuredCount > 0) {
+        process.stderr.write(`🎉 Configuration complete! Successfully configured ${configuredCount} MCP client(s).\n`);
+        process.stderr.write("Remember to restart or reload your AI client to detect the 'duo_review' tool.\n");
+        await checkGitLabConnection();
+        printMiniGuide();
+    }
+    else {
+        process.stderr.write("⚠️ No clients were configured.\n");
+    }
+}
+async function checkGitLabConnection() {
+    process.stderr.write("\nChecking GitLab CLI installation and connection...\n");
+    try {
+        const { stdout } = await execAsync("glab auth status");
+        process.stderr.write("✅ GitLab CLI and connection verified successfully!\n");
+        if (stdout) {
+            process.stderr.write(stdout
+                .trim()
+                .split("\n")
+                .map((line) => `   ${line}`)
+                .join("\n") + "\n\n");
+        }
+    }
+    catch (err) {
+        process.stderr.write("⚠️ Connection check failed or GitLab CLI not fully authenticated:\n");
+        if (err.code === "ENOENT" || (err.message && err.message.includes("not found"))) {
+            process.stderr.write("   Could not find the 'glab' executable. Please make sure GitLab CLI is installed and added to your PATH.\n\n");
+        }
+        else {
+            const errorOutput = err.stderr || err.stdout || err.message || String(err);
+            process.stderr.write(errorOutput
+                .trim()
+                .split("\n")
+                .map((line) => `   ${line}`)
+                .join("\n") + "\n\n");
+        }
+    }
+}
+function printMiniGuide() {
+    process.stderr.write(`📋 QUICK COMMAND & USAGE GUIDE
+=============================
+
+1. How to ask your AI agent to run a review:
+   - "Review my current uncommitted changes with @duo_review"
+   - "Run @duo_review on src/auth.ts and src/db.ts"
+   - "Use @duo_review with model: sonnet to review this project"
+
+2. AI Model Abstractions (Friendly Names):
+   You can use simple, friendly model names instead of complex GitLab identifiers!
+   The bridge automatically maps them for you:
+   
+   • sonnet      -> claude_sonnet_4_6
+   • haiku       -> claude_haiku_4_5_20251001
+   • opus        -> claude_opus_4_5_20251101
+   • gpt5        -> gpt_5
+   • gpt5-mini   -> gpt_5_mini
+   • gpt5-codex  -> gpt_5_codex
+   • gemini      -> gemini_2_5_flash_vertex
+
+3. How to use friendly models:
+   - In your agent's config or env: set GITLAB_DUO_MODEL="sonnet"
+   - In your prompt: "Review with @duo_review using model: gemini"
+
+=============================\n\n`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitlab-duo-mcp-bridge",
-  "version": "0.1.0",
+  "version": "0.3.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"