mcp-multiplexer 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Configuration for a single wrapped MCP server
+ */
+export interface WrappedServerConfig {
+    /**
+     * Unique prefix name for this server (used to prefix tool names)
+     */
+    name: string;
+    /**
+     * Command to execute to start the MCP server (for stdio transport)
+     * Either command or url must be specified, but not both
+     */
+    command?: string;
+    /**
+     * Arguments to pass to the command (only used with command)
+     */
+    args?: string[];
+    /**
+     * Environment variables for the server process (only used with command)
+     */
+    env?: Record<string, string>;
+    /**
+     * Working directory for the server process (only used with command)
+     */
+    cwd?: string;
+    /**
+     * URL to connect to the MCP server (for SSE transport)
+     * Either command or url must be specified, but not both
+     */
+    url?: string;
+}
+/**
+ * Configuration for the MCP wrapper server
+ */
+export interface WrapperConfig {
+    /**
+     * Name of this wrapper server
+     */
+    name: string;
+    /**
+     * Version of this wrapper server (optional, defaults to "1.0.0")
+     */
+    version?: string;
+    /**
+     * List of MCP servers to wrap
+     */
+    servers: WrappedServerConfig[];
+    /**
+     * Separator used between server name and tool name (default: "__")
+     */
+    separator?: string;
+}
+/**
+ * Information about a wrapped tool
+ */
+export interface WrappedToolInfo {
+    /**
+     * Original tool name without prefix
+     */
+    originalName: string;
+    /**
+     * Server name that owns this tool
+     */
+    serverName: string;
+    /**
+     * Prefixed tool name (serverName + separator + originalName)
+     */
+    prefixedName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Utility functions for tool name prefixing
+ */
+/**
+ * Creates a prefixed tool name by combining server name and tool name
+ */
+export declare function prefixToolName(serverName: string, toolName: string, separator?: string): string;
+/**
+ * Parses a prefixed tool name and returns the server name and original tool name
+ * Returns null if the name doesn't contain the separator
+ */
+export declare function parseToolName(prefixedName: string, separator?: string): {
+    serverName: string;
+    originalName: string;
+} | null;
+/**
+ * Validates that a server name doesn't contain the separator
+ */
+export declare function isValidServerName(serverName: string, separator?: string): boolean;
+/**
+ * Validates that a tool name doesn't contain the separator
+ */
+export declare function isValidToolName(toolName: string, separator?: string): boolean;
+/**
+ * Returns supplemental environment variables that should be passed to child processes
+ * to work around the SDK's restrictive env whitelist on Windows.
+ * On non-Windows platforms, returns an empty object.
+ */
+export declare function getSupplementalEnv(): Record<string, string>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAA0B,GACpC,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAA0B,GACpC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAcrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAA0B,GACpC,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAA0B,GACpC,OAAO,CAET;AAWD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY3D"}

package/dist/utils.js

@@ -0,0 +1,65 @@
+/**
+ * Utility functions for tool name prefixing
+ */
+const DEFAULT_SEPARATOR = "__";
+/**
+ * Creates a prefixed tool name by combining server name and tool name
+ */
+export function prefixToolName(serverName, toolName, separator = DEFAULT_SEPARATOR) {
+    return `${serverName}${separator}${toolName}`;
+}
+/**
+ * Parses a prefixed tool name and returns the server name and original tool name
+ * Returns null if the name doesn't contain the separator
+ */
+export function parseToolName(prefixedName, separator = DEFAULT_SEPARATOR) {
+    const separatorIndex = prefixedName.indexOf(separator);
+    if (separatorIndex === -1) {
+        return null;
+    }
+    const serverName = prefixedName.substring(0, separatorIndex);
+    const originalName = prefixedName.substring(separatorIndex + separator.length);
+    if (!serverName || !originalName) {
+        return null;
+    }
+    return { serverName, originalName };
+}
+/**
+ * Validates that a server name doesn't contain the separator
+ */
+export function isValidServerName(serverName, separator = DEFAULT_SEPARATOR) {
+    return !serverName.includes(separator);
+}
+/**
+ * Validates that a tool name doesn't contain the separator
+ */
+export function isValidToolName(toolName, separator = DEFAULT_SEPARATOR) {
+    return !toolName.includes(separator);
+}
+/**
+ * Environment variables that are missing from the SDK's DEFAULT_INHERITED_ENV_VARS
+ * whitelist on Windows but are required by common tools (e.g. OpenSSH needs ProgramData).
+ */
+const ADDITIONAL_WINDOWS_ENV_VARS = [
+    'ProgramData',
+    'ALLUSERSPROFILE',
+];
+/**
+ * Returns supplemental environment variables that should be passed to child processes
+ * to work around the SDK's restrictive env whitelist on Windows.
+ * On non-Windows platforms, returns an empty object.
+ */
+export function getSupplementalEnv() {
+    if (process.platform !== 'win32') {
+        return {};
+    }
+    const env = {};
+    for (const key of ADDITIONAL_WINDOWS_ENV_VARS) {
+        const value = process.env[key];
+        if (value !== undefined) {
+            env[key] = value;
+        }
+    }
+    return env;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,QAAgB,EAChB,YAAoB,iBAAiB;IAErC,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAoB,EACpB,YAAoB,iBAAiB;IAErC,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,YAAY,CAAC,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAE/E,IAAI,CAAC,UAAU,IAAI,CAAC,YAAY,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,YAAoB,iBAAiB;IAErC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,YAAoB,iBAAiB;IAErC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,2BAA2B,GAAG;IAClC,aAAa;IACb,iBAAiB;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,2BAA2B,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/wrapper.d.ts

@@ -0,0 +1,72 @@
+import type { WrapperConfig } from "./types.js";
+/**
+ * MCP Wrapper Server that prefixes tool names from multiple underlying MCP servers
+ * to prevent naming collisions.
+ */
+export declare class McpWrapper {
+    private config;
+    private separator;
+    private connectedServers;
+    private failedServers;
+    private server;
+    private toolToServerMap;
+    constructor(config: WrapperConfig);
+    /**
+     * Creates a prefixed tool name
+     */
+    private prefixToolName;
+    /**
+     * Looks up tool mapping from the tool name to server map
+     */
+    private lookupToolMapping;
+    /**
+     * Connects to a single underlying MCP server
+     */
+    private connectToServer;
+    /**
+     * Registers tool mappings for a connected server
+     */
+    private registerToolMappings;
+    /**
+     * Helper method to connect and register a server
+     */
+    private connectAndRegisterServer;
+    /**
+     * Reconnects to a specific server by name
+     */
+    reconnectServer(serverName: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Connects to all configured underlying MCP servers
+     * Skips servers that fail to connect and tracks them for retry
+     */
+    connectToServers(): Promise<void>;
+    /**
+     * Cleans up all connected servers (used during error recovery)
+     */
+    private cleanupConnectedServers;
+    /**
+     * Sets up request handlers for the wrapper server
+     */
+    private setupHandlers;
+    /**
+     * Starts the wrapper server using stdio transport
+     */
+    start(): Promise<void>;
+    /**
+     * Closes all connections and stops the server
+     */
+    close(): Promise<void>;
+    /**
+     * Returns information about all wrapped tools
+     */
+    getWrappedTools(): Array<{
+        serverName: string;
+        originalName: string;
+        prefixedName: string;
+        description?: string;
+    }>;
+}
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAuB,MAAM,YAAY,CAAC;AA0BrE;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,aAAa,CAA0E;IAC/F,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAwE;gBAEnF,MAAM,EAAE,aAAa;IAoDjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;YACW,eAAe;IA+H7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;YACW,wBAAwB;IA4BtC;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BzF;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoDvC;;OAEG;YACW,uBAAuB;IAarC;;OAEG;IACH,OAAO,CAAC,aAAa;IAoJrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B;;OAEG;IACH,eAAe,IAAI,KAAK,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CAqBH"}