@aiwerk/mcp-bridge 1.2.1 → 1.2.3

package/README.md

@@ -1,5 +1,9 @@
 # @aiwerk/mcp-bridge
 
+[![Tests](https://github.com/AIWerk/mcp-bridge/actions/workflows/test.yml/badge.svg)](https://github.com/AIWerk/mcp-bridge/actions/workflows/test.yml)
+[![npm version](https://img.shields.io/npm/v/@aiwerk/mcp-bridge.svg)](https://www.npmjs.com/package/@aiwerk/mcp-bridge)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Multiplex multiple MCP servers into one interface. One config, one connection, all your tools.
 
 Works with **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **OpenClaw**, or any MCP client.

package/dist/src/config.d.ts

@@ -1,4 +1,15 @@
 import { BridgeConfig, Logger } from "./types.js";
+/**
+ * Load ~/.openclaw/.env as a fallback env source.
+ *
+ * When running as an OpenClaw plugin, dotenv uses `override: false` which means
+ * pre-existing env vars (even empty strings) take precedence over .env values.
+ * This fallback allows the bridge to recover the intended .env values when
+ * process.env has empty/missing entries.
+ */
+export declare function loadOpenClawDotEnvFallback(): Record<string, string>;
+/** Reset the cached OpenClaw .env (for testing). */
+export declare function resetOpenClawDotEnvCache(): void;
 /** Parse a simple KEY=VALUE .env file (no npm dependency). */
 export declare function parseEnvFile(content: string): Record<string, string>;
 export interface LoadConfigOptions {

package/dist/src/config.js

@@ -6,6 +6,37 @@ import { randomBytes } from "crypto";
 const DEFAULT_CONFIG_DIR = join(homedir(), ".mcp-bridge");
 const DEFAULT_CONFIG_FILE = "config.json";
 const DEFAULT_ENV_FILE = ".env";
+/** Cached fallback env from ~/.openclaw/.env (loaded once). */
+let _openclawDotEnvCache = null;
+/**
+ * Load ~/.openclaw/.env as a fallback env source.
+ *
+ * When running as an OpenClaw plugin, dotenv uses `override: false` which means
+ * pre-existing env vars (even empty strings) take precedence over .env values.
+ * This fallback allows the bridge to recover the intended .env values when
+ * process.env has empty/missing entries.
+ */
+export function loadOpenClawDotEnvFallback() {
+    if (_openclawDotEnvCache !== null)
+        return _openclawDotEnvCache;
+    const openclawEnvPath = join(process.env.OPENCLAW_CONFIG_DIR || join(homedir(), ".openclaw"), ".env");
+    if (existsSync(openclawEnvPath)) {
+        try {
+            _openclawDotEnvCache = parseEnvFile(readFileSync(openclawEnvPath, "utf-8"));
+        }
+        catch {
+            _openclawDotEnvCache = {};
+        }
+    }
+    else {
+        _openclawDotEnvCache = {};
+    }
+    return _openclawDotEnvCache;
+}
+/** Reset the cached OpenClaw .env (for testing). */
+export function resetOpenClawDotEnvCache() {
+    _openclawDotEnvCache = null;
+}
 /** Parse a simple KEY=VALUE .env file (no npm dependency). */
 export function parseEnvFile(content) {
     const env = {};

package/dist/src/transport-base.js

@@ -1,3 +1,4 @@
+import { loadOpenClawDotEnvFallback } from "./config.js";
 /**
  * Base class for all MCP transports. Provides shared logic for:
  * - Message handling (JSON-RPC response routing, notification dispatch)
@@ -119,6 +120,15 @@ export class BaseTransport {
 export function resolveEnvVars(value, contextDescription, extraEnv) {
     return value.replace(/\$\{(\w+)\}/g, (_, varName) => {
         const resolved = extraEnv?.[varName] ?? process.env[varName];
+        // If resolved is undefined or empty string, try the OpenClaw .env fallback.
+        // This handles the case where dotenv(override:false) didn't overwrite a
+        // pre-existing empty env var in process.env.
+        if (resolved === undefined || resolved === "") {
+            const fallback = loadOpenClawDotEnvFallback()[varName];
+            if (fallback !== undefined && fallback !== "") {
+                return fallback;
+            }
+        }
         if (resolved === undefined) {
             throw new Error(`[mcp-bridge] Missing required environment variable "${varName}" while resolving ${contextDescription}`);
         }

package/dist/src/transport-stdio.js

@@ -25,8 +25,30 @@ export class StdioTransport extends BaseTransport {
     async startProcess() {
         if (!this.config.command)
             return;
-        const env = { ...process.env, ...resolveEnvRecord(this.config.env || {}, "env key") };
+        const configEnv = resolveEnvRecord(this.config.env || {}, "env key");
+        const env = { ...process.env, ...configEnv };
         const args = resolveArgs(this.config.args || [], env);
+        if (process.env.DEBUG_STDIO_ENV) {
+            this.logger.info(`[mcp-bridge] stdio spawn: ${this.config.command} ${args.join(" ")}`);
+            for (const [key, value] of Object.entries(configEnv)) {
+                const len = value.length;
+                const head = len > 4 ? value.slice(0, 4) : "****";
+                const tail = len > 4 ? value.slice(-4) : "****";
+                const hasPlaceholder = /\$\{/.test(value);
+                const inProcessEnv = process.env[key] !== undefined;
+                const processEnvLen = inProcessEnv ? (process.env[key]?.length ?? 0) : -1;
+                const processEnvMatch = inProcessEnv ? (process.env[key] === value) : null;
+                this.logger.info(`[mcp-bridge] stdio env: ${key} len=${len} head=${head}... tail=...${tail} placeholder=${hasPlaceholder} inProcessEnv=${inProcessEnv}(len=${processEnvLen}, match=${processEnvMatch})`);
+            }
+            // Log the FINAL merged value that the child will receive
+            for (const key of Object.keys(configEnv)) {
+                const finalVal = env[key] ?? "(undefined)";
+                const finalLen = typeof finalVal === "string" ? finalVal.length : -1;
+                const finalHead = typeof finalVal === "string" && finalLen > 4 ? finalVal.slice(0, 4) : "****";
+                const finalTail = typeof finalVal === "string" && finalLen > 4 ? finalVal.slice(-4) : "****";
+                this.logger.info(`[mcp-bridge] stdio env FINAL: ${key} len=${finalLen} head=${finalHead}... tail=...${finalTail}`);
+            }
+        }
         this.process = spawn(this.config.command, args, {
             stdio: ["pipe", "pipe", "pipe"],
             env
@@ -34,6 +56,9 @@ export class StdioTransport extends BaseTransport {
         if (!this.process.stdin || !this.process.stdout || !this.process.stderr) {
             throw new Error("Failed to create process pipes");
         }
+        if (process.env.DEBUG_STDIO_ENV) {
+            this.logger.info(`[mcp-bridge] stdio child PID: ${this.process.pid} (check /proc/${this.process.pid}/environ if needed)`);
+        }
         this.framingMode = this.config.framing || "auto";
         this.stdoutBuffer = Buffer.alloc(0);
         this.process.stdout.on("data", (data) => {
@@ -48,7 +73,13 @@ export class StdioTransport extends BaseTransport {
             this.processStdoutBuffer();
         });
         this.process.stderr.on("data", (data) => {
-            this.logger.debug(`MCP server stderr: ${data.toString()}`);
+            const msg = data.toString();
+            if (process.env.DEBUG_STDIO_ENV) {
+                this.logger.info(`[mcp-bridge] stdio stderr: ${msg.trimEnd()}`);
+            }
+            else {
+                this.logger.debug(`MCP server stderr: ${msg}`);
+            }
         });
         this.process.on("exit", (code, signal) => {
             this.logger.debug(`MCP server process exited: code=${code}, signal=${signal}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwerk/mcp-bridge",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Standalone MCP server that multiplexes multiple MCP servers into one interface",
   "type": "module",
   "main": "./dist/src/index.js",

package/servers/atlassian/README.md

@@ -0,0 +1,72 @@
+# Atlassian MCP Server
+
+Confluence wiki and Jira project management - search, create, and update pages and issues.
+
+## Requirements
+- Python + uvx (or pip)
+- Atlassian Cloud or Server/Data Center instance
+- API token for authentication
+
+## Quick Install
+
+### Linux / macOS
+```bash
+# Using mcp-bridge CLI:
+mcp-bridge install atlassian
+```
+
+### Windows (PowerShell)
+```powershell
+# Using mcp-bridge CLI:
+mcp-bridge install atlassian
+```
+
+### Manual Setup
+1. Get your API token: https://id.atlassian.com/manage-profile/security/api-tokens
+2. Add to .env:
+   ```
+   CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
+   CONFLUENCE_USERNAME=your@email.com
+   CONFLUENCE_API_TOKEN=your_token
+   JIRA_URL=https://your-domain.atlassian.net
+   JIRA_USERNAME=your@email.com
+   JIRA_API_TOKEN=your_token
+   ```
+3. Add config to ~/.mcp-bridge/config.json (see config.json)
+4. Restart mcp-bridge
+
+## Configuration
+
+You can use Confluence only, Jira only, or both. Just set the env vars for the services you need.
+
+### Cloud vs Server/Data Center
+- **Cloud**: Use API token authentication (as above)
+- **Server/DC**: Use personal access token instead:
+  ```
+  CONFLUENCE_PERSONAL_TOKEN=your_pat
+  JIRA_PERSONAL_TOKEN=your_pat
+  ```
+
+## What you get
+
+### Confluence (12+ tools)
+- Search pages and spaces
+- Read, create, update, and delete pages
+- Manage labels and attachments
+- Get page comments
+
+### Jira (10+ tools)
+- Search issues (JQL)
+- Create, update, and transition issues
+- Manage sprints and boards
+- Add comments and attachments
+
+72 tools total. Uses [sooperset/mcp-atlassian](https://github.com/sooperset/mcp-atlassian) (MIT license).
+
+## Remove
+
+```bash
+./install-server.sh atlassian --remove
+```
+
+Removes the server from config and cleans up the API tokens. The server recipe stays in `servers/atlassian/` for easy reinstall.

package/servers/atlassian/env_vars

@@ -0,0 +1,6 @@
+CONFLUENCE_URL
+CONFLUENCE_USERNAME
+CONFLUENCE_API_TOKEN
+JIRA_URL
+JIRA_USERNAME
+JIRA_API_TOKEN

package/servers/atlassian/install.ps1

@@ -0,0 +1,3 @@
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ServerName = Split-Path -Leaf $ScriptDir
+& (Join-Path $ScriptDir "..\..\install-server.ps1") $ServerName @args

package/servers/atlassian/install.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_NAME="$(basename "$SCRIPT_DIR")"
+exec "$SCRIPT_DIR/../../install-server.sh" "$SERVER_NAME" "$@"

package/servers/chrome-devtools/README.md

@@ -0,0 +1,69 @@
+# Chrome DevTools MCP Server
+
+Control and inspect a live Chrome browser for automation, debugging, and performance analysis.
+
+## Requirements
+- Node.js + npx
+- Chrome >= 144 (stable channel)
+- No API key needed
+
+## Quick Install
+
+### Linux / macOS
+```bash
+# Using mcp-bridge CLI:
+mcp-bridge install chrome-devtools
+```
+
+### Windows (PowerShell)
+```powershell
+# Using mcp-bridge CLI:
+mcp-bridge install chrome-devtools
+```
+
+### Manual Setup
+1. Enable remote debugging in Chrome: open `chrome://inspect/#remote-debugging` and toggle it on
+2. Add config to ~/.mcp-bridge/config.json (see config.json)
+3. Restart mcp-bridge
+
+## Connection Modes
+
+### Auto-connect (default, recommended)
+Connects to your running Chrome via native pipe. Chrome shows a permission dialog on each connection.
+```json
+"args": ["-y", "chrome-devtools-mcp@0.20.0", "--autoConnect"]
+```
+
+### Browser URL
+Connect to Chrome running with `--remote-debugging-port=9222`. No dialog needed.
+```json
+"args": ["-y", "chrome-devtools-mcp@0.20.0", "--browserUrl", "http://127.0.0.1:9222"]
+```
+
+### Headless (standalone)
+Launches its own headless Chrome instance. No existing browser needed.
+```json
+"args": ["-y", "chrome-devtools-mcp@0.20.0", "--headless"]
+```
+
+## What you get
+- **Navigation** (6 tools): navigate, open/close/list/select pages, wait for content
+- **Input** (9 tools): click, hover, drag, fill forms, type text, press keys, upload files, handle dialogs
+- **Debugging** (5 tools): page snapshots, screenshots, JS evaluation, console messages
+- **Network** (2 tools): list/inspect network requests with full request/response bodies
+- **Performance** (4 tools): record traces, analyze insights, memory snapshots, Lighthouse audits
+- **Emulation** (2 tools): viewport, network throttling, geolocation, dark mode
+
+28 tools total. See [full tool reference](https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/tool-reference.md).
+
+## Privacy Notes
+- Google collects usage statistics by default. Opt out with `--no-usage-statistics`
+- Performance tools may send URLs to Google CrUX API. Disable with `--no-performance-crux`
+
+## Remove
+
+```bash
+./install-server.sh chrome-devtools --remove
+```
+
+Removes the server from config. The server recipe stays in `servers/chrome-devtools/` for easy reinstall.

package/servers/chrome-devtools/config.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "name": "chrome-devtools",
+  "description": "Control and inspect a live Chrome browser for automation, debugging, and performance analysis",
+  "transport": "stdio",
+  "command": "npx",
+  "args": [
+    "-y",
+    "chrome-devtools-mcp@0.20.0",
+    "--autoConnect"
+  ],
+  "env": {},
+  "authRequired": false,
+  "homepage": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
+  "notes": "Requires Chrome >= 144 with remote debugging enabled at chrome://inspect/#remote-debugging. Chrome will show a permission dialog on each connection."
+}

package/servers/chrome-devtools/install.ps1

@@ -0,0 +1,3 @@
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ServerName = Split-Path -Leaf $ScriptDir
+& (Join-Path $ScriptDir "..\..\install-server.ps1") $ServerName @args

package/servers/chrome-devtools/install.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_NAME="$(basename "$SCRIPT_DIR")"
+exec "$SCRIPT_DIR/../../install-server.sh" "$SERVER_NAME" "$@"

package/servers/index.json

@@ -1,6 +1,15 @@
 {
   "schemaVersion": 1,
   "servers": {
+    "chrome-devtools": {
+      "description": "Control and inspect a live Chrome browser",
+      "transport": "stdio",
+      "authRequired": false,
+      "homepage": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
+      "installMethod": "npx",
+      "envVars": [],
+      "notes": "Requires Chrome >= 144 with chrome://inspect/#remote-debugging enabled"
+    },
     "apify": {
       "description": "web scraping & automation",
       "transport": "streamable-http",