@aiwerk/mcp-bridge 1.2.3 → 1.3.0

package/README.md

@@ -115,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 |
@@ -186,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/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.3",
+  "version": "1.3.0",
   "description": "Standalone MCP server that multiplexes multiple MCP servers into one interface",
   "type": "module",
   "main": "./dist/src/index.js",