@aiwerk/mcp-bridge 1.2.2 → 1.3.0

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.
@@ -111,10 +115,38 @@ Config: `~/.mcp-bridge/config.json` | Secrets: `~/.mcp-bridge/.env`
   },
   "toolPrefix": true,
   "connectionTimeoutMs": 5000,
-  "requestTimeoutMs": 60000
+  "requestTimeoutMs": 60000,
+  "schemaCompression": {
+    "enabled": true,
+    "maxDescriptionLength": 80
+  }
+}
+```
+
+### Schema Compression
+
+In router mode, tool descriptions from upstream servers can be verbose (100-300+ chars each). Schema compression truncates them to save tokens:
+
+- **Enabled by default** — descriptions capped at 80 characters
+- Cuts at sentence boundary when possible, otherwise word boundary
+- Use `action=schema` to retrieve the full uncompressed schema for any tool on demand
+
+```json
+"schemaCompression": {
+  "enabled": true,
+  "maxDescriptionLength": 80
 }
 ```
 
+**Token savings example:** 30 Todoist tools: ~2800 tokens uncompressed -> ~1200 compressed (~57% reduction).
+
+To get full details for a specific tool:
+```
+mcp(server="todoist", action="schema", tool="find-tasks")
+```
+
+Set `"enabled": false` to disable compression and return full descriptions.
+
 ### Modes
 
 | Mode | Tools exposed | Best for |
@@ -182,6 +214,9 @@ Built-in catalog with pre-configured servers:
 | wise | stdio | International payments |
 | tavily | stdio | AI-optimized web search |
 | apify | streamable-http | Web scraping and automation |
+| atlassian | stdio | Confluence and Jira |
+| chrome-devtools | stdio | Chrome browser automation |
+| hostinger | sse | Web hosting management |
 
 ```bash
 mcp-bridge install todoist    # Interactive setup with API key prompt

package/dist/src/mcp-router.d.ts

@@ -26,6 +26,12 @@ export type RouterDispatchResponse = {
     action: "call";
     tool: string;
     result: any;
+} | {
+    server: string;
+    action: "schema";
+    tool: string;
+    schema: any;
+    description: string;
 } | {
     action: "status";
     servers: RouterServerStatus[];

package/dist/src/mcp-router.js

@@ -2,6 +2,7 @@ import { SseTransport } from "./transport-sse.js";
 import { StdioTransport } from "./transport-stdio.js";
 import { StreamableHttpTransport } from "./transport-streamable-http.js";
 import { fetchToolsList, initializeProtocol, PACKAGE_VERSION } from "./protocol.js";
+import { compressDescription } from "./schema-compression.js";
 const DEFAULT_IDLE_TIMEOUT_MS = 10 * 60 * 1000;
 const DEFAULT_MAX_CONCURRENT = 5;
 export class McpRouter {
@@ -59,10 +60,28 @@ export class McpRouter {
                     return this.error("connection_failed", `Failed to connect to ${server}: ${error instanceof Error ? error.message : String(error)}`);
                 }
             }
+            if (normalizedAction === "schema") {
+                if (!tool) {
+                    return this.error("invalid_params", "tool is required for action=schema");
+                }
+                try {
+                    await this.getToolList(server);
+                }
+                catch (error) {
+                    return this.error("connection_failed", `Failed to connect to ${server}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                const state = this.states.get(server);
+                const fullTool = state.fullToolsMap?.get(tool);
+                if (!fullTool) {
+                    return this.error("unknown_tool", `Tool '${tool}' not found on server '${server}'`, state.toolNames);
+                }
+                return { server, action: "schema", tool, schema: fullTool.inputSchema, description: fullTool.description };
+            }
             if (normalizedAction === "refresh") {
                 try {
                     const state = await this.ensureConnected(server);
                     state.toolsCache = undefined;
+                    state.fullToolsMap = undefined;
                     state.toolNames = [];
                     const tools = await this.getToolList(server);
                     return { server, action: "refresh", refreshed: true, tools };
@@ -72,7 +91,7 @@ export class McpRouter {
                 }
             }
             if (normalizedAction !== "call") {
-                return this.error("invalid_params", `action must be one of: list, call, refresh`);
+                return this.error("invalid_params", `action must be one of: list, call, refresh, schema`);
             }
             if (!tool) {
                 return this.error("invalid_params", "tool is required for action=call");
@@ -116,9 +135,15 @@ export class McpRouter {
         }
         const tools = await fetchToolsList(state.transport);
         state.toolNames = tools.map((tool) => tool.name);
+        // Store full tool metadata for action=schema
+        state.fullToolsMap = new Map(tools.map((tool) => [tool.name, { description: tool.description || "", inputSchema: tool.inputSchema }]));
+        const compressionEnabled = this.clientConfig.schemaCompression?.enabled ?? true;
+        const maxLen = this.clientConfig.schemaCompression?.maxDescriptionLength ?? 80;
         state.toolsCache = tools.map((tool) => ({
             name: tool.name,
-            description: tool.description || "",
+            description: compressionEnabled
+                ? compressDescription(tool.description || "", maxLen)
+                : (tool.description || ""),
             requiredParams: this.extractRequiredParams(tool)
         }));
         this.markUsed(server);
@@ -213,6 +238,7 @@ export class McpRouter {
         }
         state.initialized = false;
         state.toolsCache = undefined;
+        state.fullToolsMap = undefined;
         state.toolNames = [];
     }
     markUsed(server) {
@@ -240,6 +266,7 @@ export class McpRouter {
                 return;
             state.initialized = false;
             state.toolsCache = undefined;
+            state.fullToolsMap = undefined;
             state.toolNames = [];
         };
         if (serverConfig.transport === "sse") {

package/dist/src/schema-compression.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Compress tool descriptions to reduce token usage in router tool listings.
+ */
+export declare function compressDescription(desc: string, maxLen?: number): string;

package/dist/src/schema-compression.js

@@ -0,0 +1,21 @@
+/**
+ * Compress tool descriptions to reduce token usage in router tool listings.
+ */
+export function compressDescription(desc, maxLen = 80) {
+    if (desc.length <= maxLen) {
+        return desc;
+    }
+    // Try to cut at sentence boundary (". " before maxLen)
+    const searchArea = desc.slice(0, maxLen);
+    const sentenceEnd = searchArea.lastIndexOf(". ");
+    if (sentenceEnd > 0) {
+        return desc.slice(0, sentenceEnd + 1) + "\u2026";
+    }
+    // Fall back to word boundary
+    const lastSpace = searchArea.lastIndexOf(" ");
+    if (lastSpace > 0) {
+        return desc.slice(0, lastSpace) + "\u2026";
+    }
+    // No word boundary found, hard truncate
+    return desc.slice(0, maxLen) + "\u2026";
+}

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/dist/src/types.d.ts

@@ -24,6 +24,10 @@ export interface McpClientConfig {
     requestTimeoutMs?: number;
     routerIdleTimeoutMs?: number;
     routerMaxConcurrent?: number;
+    schemaCompression?: {
+        enabled?: boolean;
+        maxDescriptionLength?: number;
+    };
 }
 export interface McpTool {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwerk/mcp-bridge",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "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",