@alsania-io/mcpnyx 0.0.1

package/dist/gateways/stdioToWs.js

@@ -0,0 +1,115 @@
+import express from 'express';
+import cors from 'cors';
+import { createServer } from 'http';
+import { spawn } from 'child_process';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { getVersion } from '../lib/getVersion.js';
+import { WebSocketServerTransport } from '../server/websocket.js';
+import { onSignals } from '../lib/onSignals.js';
+import { serializeCorsOrigin } from '../lib/serializeCorsOrigin.js';
+export async function stdioToWs(args) {
+    const { stdioCmd, port, host, messagePath, logger, healthEndpoints, corsOrigin } = args;
+    logger.info(`  - host: ${host}`);
+    logger.info(`  - port: ${port}`);
+    logger.info(`  - stdio: ${stdioCmd}`);
+    logger.info(`  - messagePath: ${messagePath}`);
+    logger.info(`  - CORS: ${corsOrigin ? `enabled (${serializeCorsOrigin({ corsOrigin })})` : 'disabled'}`);
+    logger.info(`  - Health endpoints: ${healthEndpoints.length ? healthEndpoints.join(', ') : '(none)'}`);
+    let wsTransport = null;
+    let child = null;
+    let isReady = false;
+    const cleanup = () => {
+        if (wsTransport) {
+            wsTransport.close().catch((err) => {
+                logger.error(`Error stopping WebSocket server: ${err.message}`);
+            });
+        }
+        if (child) {
+            child.kill();
+        }
+    };
+    onSignals({
+        logger,
+        cleanup,
+    });
+    try {
+        child = spawn(stdioCmd, { shell: true });
+        child.on('exit', (code, signal) => {
+            logger.error(`Child exited: code=${code}, signal=${signal}`);
+            cleanup();
+            process.exit(code ?? 1);
+        });
+        const server = new Server({ name: 'mcp-nyx', version: getVersion() }, { capabilities: {} });
+        // Handle child process output
+        let buffer = '';
+        child.stdout.on('data', (chunk) => {
+            buffer += chunk.toString('utf8');
+            const lines = buffer.split(/\r?\n/);
+            buffer = lines.pop() ?? '';
+            lines.forEach((line) => {
+                if (!line.trim())
+                    return;
+                try {
+                    const jsonMsg = JSON.parse(line);
+                    logger.info(`Child → WebSocket: ${JSON.stringify(jsonMsg)}`);
+                    // Broadcast to all connected clients
+                    wsTransport?.send(jsonMsg, jsonMsg.id).catch((err) => {
+                        logger.error('Failed to broadcast message:', err);
+                    });
+                }
+                catch {
+                    logger.error(`Child non-JSON: ${line}`);
+                }
+            });
+        });
+        child.stderr.on('data', (chunk) => {
+            logger.info(`Child stderr: ${chunk.toString('utf8')}`);
+        });
+        const app = express();
+        if (corsOrigin) {
+            app.use(cors({ origin: corsOrigin }));
+        }
+        for (const ep of healthEndpoints) {
+            app.get(ep, (_req, res) => {
+                if (child?.killed) {
+                    res.status(500).send('Child process has been killed');
+                }
+                if (!isReady) {
+                    res.status(500).send('Server is not ready');
+                }
+                res.send('ok');
+            });
+        }
+        const httpServer = createServer(app);
+        wsTransport = new WebSocketServerTransport({
+            path: messagePath,
+            server: httpServer,
+        });
+        await server.connect(wsTransport);
+        wsTransport.onmessage = (msg) => {
+            const line = JSON.stringify(msg);
+            logger.info(`WebSocket → Child: ${line}`);
+            child.stdin.write(line + '\n');
+        };
+        wsTransport.onconnection = (clientId) => {
+            logger.info(`New WebSocket connection: ${clientId}`);
+        };
+        wsTransport.ondisconnection = (clientId) => {
+            logger.info(`WebSocket connection closed: ${clientId}`);
+        };
+        wsTransport.onerror = (err) => {
+            logger.error(`WebSocket error: ${err.message}`);
+        };
+        isReady = true;
+        httpServer.listen(port, host, () => {
+            logger.info(`Listening on ${host}:${port}`);
+            logger.info(`WebSocket endpoint: ws://${host}:${port}${messagePath}`);
+        });
+    }
+    catch (err) {
+        logger.error(`Failed to start: ${err.message}`);
+        cleanup();
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=stdioToWs.js.map

package/dist/gateways/stdioToWs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioToWs.js","sourceRoot":"","sources":["../../src/gateways/stdioToWs.ts"],"names":[],"mappings":"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"}

package/dist/gateways/streamableHttpToSse.d.ts

@@ -0,0 +1,16 @@
+import { type CorsOptions } from 'cors';
+import { Logger } from '../types.js';
+export interface StreamableHttpToSseArgs {
+    streamableHttpUrl: string;
+    port: number;
+    host: string;
+    baseUrl: string;
+    ssePath: string;
+    messagePath: string;
+    logger: Logger;
+    corsOrigin: CorsOptions['origin'];
+    healthEndpoints: string[];
+    headers: Record<string, string>;
+}
+export declare function streamableHttpToSse(args: StreamableHttpToSseArgs): Promise<void>;
+//# sourceMappingURL=streamableHttpToSse.d.ts.map

package/dist/gateways/streamableHttpToSse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamableHttpToSse.d.ts","sourceRoot":"","sources":["../../src/gateways/streamableHttpToSse.ts"],"names":[],"mappings":"AAEA,OAAa,EAAE,KAAK,WAAW,EAAE,MAAM,MAAM,CAAC;AAc9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AA2CD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,iBAmNtE"}

package/dist/gateways/streamableHttpToSse.js

@@ -0,0 +1,219 @@
+import express from 'express';
+import bodyParser from 'body-parser';
+import cors from 'cors';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { InitializeRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { getVersion } from '../lib/getVersion.js';
+import { onSignals } from '../lib/onSignals.js';
+import { serializeCorsOrigin } from '../lib/serializeCorsOrigin.js';
+let streamableHttpClient;
+const newInitializeStreamableHttpClient = ({ message }) => {
+    const clientInfo = message.params?.clientInfo;
+    const clientCapabilities = message.params?.capabilities;
+    return new Client({
+        name: clientInfo?.name ?? 'mcp-nyx',
+        version: clientInfo?.version ?? getVersion(),
+    }, {
+        capabilities: clientCapabilities ?? {},
+    });
+};
+const newFallbackStreamableHttpClient = async ({ streamableHttpTransport, }) => {
+    const fallbackStreamableHttpClient = new Client({
+        name: 'mcp-nyx',
+        version: getVersion(),
+    }, {
+        capabilities: {},
+    });
+    await fallbackStreamableHttpClient.connect(streamableHttpTransport);
+    return fallbackStreamableHttpClient;
+};
+const setResponseHeaders = ({ res, headers }) => Object.entries(headers).forEach(([key, value]) => {
+    res.setHeader(key, value);
+});
+export async function streamableHttpToSse(args) {
+    const { streamableHttpUrl, port, host, baseUrl, ssePath, messagePath, logger, corsOrigin, healthEndpoints, headers } = args;
+    logger.info(`  - input StreamableHttp: ${streamableHttpUrl}`);
+    logger.info(`  - Headers: ${Object.keys(headers).length ? JSON.stringify(headers) : '(none)'}`);
+    logger.info(`  - host: ${host}`);
+    logger.info(`  - port: ${port}`);
+    if (baseUrl) {
+        logger.info(`  - baseUrl: ${baseUrl}`);
+    }
+    logger.info(`  - ssePath: ${ssePath}`);
+    logger.info(`  - messagePath: ${messagePath}`);
+    logger.info(`  - CORS: ${corsOrigin ? `enabled (${serializeCorsOrigin({ corsOrigin })})` : 'disabled'}`);
+    logger.info(`  - Health endpoints: ${healthEndpoints.length ? healthEndpoints.join(', ') : '(none)'}`);
+    onSignals({ logger });
+    const inputStreamableHttpTransport = new StreamableHTTPClientTransport(new URL(streamableHttpUrl), {
+        requestInit: {
+            headers,
+        },
+    });
+    inputStreamableHttpTransport.onerror = (err) => {
+        logger.error('Input StreamableHttp error:', err);
+    };
+    inputStreamableHttpTransport.onclose = () => {
+        logger.error('Input StreamableHttp connection closed');
+        process.exit(1);
+    };
+    const outputServer = new Server({ name: 'mcp-nyx', version: getVersion() }, { capabilities: {} });
+    const sessions = {};
+    const app = express();
+    if (corsOrigin) {
+        app.use(cors({ origin: corsOrigin }));
+    }
+    app.use((req, res, next) => {
+        if (req.path === messagePath)
+            return next();
+        return bodyParser.json()(req, res, next);
+    });
+    for (const ep of healthEndpoints) {
+        app.get(ep, (_req, res) => {
+            setResponseHeaders({
+                res,
+                headers,
+            });
+            res.send('ok');
+        });
+    }
+    app.get(ssePath, async (req, res) => {
+        logger.info(`New SSE connection from ${req.ip}`);
+        setResponseHeaders({
+            res,
+            headers,
+        });
+        const outputSseTransport = new SSEServerTransport(`${baseUrl}${messagePath}`, res);
+        await outputServer.connect(outputSseTransport);
+        const sessionId = outputSseTransport.sessionId;
+        if (sessionId) {
+            sessions[sessionId] = { transport: outputSseTransport, response: res };
+        }
+        const wrapResponse = (req, payload) => ({
+            jsonrpc: req.jsonrpc || '2.0',
+            id: req.id,
+            ...payload,
+        });
+        outputSseTransport.onmessage = async (message) => {
+            const isRequest = 'method' in message && 'id' in message;
+            if (isRequest) {
+                logger.info(`Output SSE → Input StreamableHttp (session ${sessionId}):`, message);
+                const req = message;
+                let result;
+                try {
+                    if (!streamableHttpClient) {
+                        if (message.method === 'initialize') {
+                            streamableHttpClient = newInitializeStreamableHttpClient({
+                                message,
+                            });
+                            const originalRequest = streamableHttpClient.request;
+                            streamableHttpClient.request = async function (requestMessage, ...restArgs) {
+                                if (InitializeRequestSchema.safeParse(requestMessage).success &&
+                                    message.params?.protocolVersion &&
+                                    requestMessage.params?.protocolVersion) {
+                                    requestMessage.params.protocolVersion = message.params.protocolVersion;
+                                }
+                                result = await originalRequest.apply(this, [requestMessage, ...restArgs]);
+                                return result;
+                            };
+                            await streamableHttpClient.connect(inputStreamableHttpTransport);
+                            streamableHttpClient.request = originalRequest;
+                        }
+                        else {
+                            logger.info('StreamableHttp client not initialized, creating fallback client');
+                            streamableHttpClient = await newFallbackStreamableHttpClient({
+                                streamableHttpTransport: inputStreamableHttpTransport,
+                            });
+                        }
+                        logger.info('Input StreamableHttp connected');
+                    }
+                    else {
+                        result = await streamableHttpClient.request(req, z.any());
+                    }
+                }
+                catch (err) {
+                    logger.error('Request error:', err);
+                    const errorCode = err && typeof err === 'object' && 'code' in err ? err.code : -32000;
+                    let errorMsg = err && typeof err === 'object' && 'message' in err ? err.message : 'Internal error';
+                    const prefix = `MCP error ${errorCode}:`;
+                    if (errorMsg.startsWith(prefix)) {
+                        errorMsg = errorMsg.slice(prefix.length).trim();
+                    }
+                    const errorResp = wrapResponse(req, {
+                        error: {
+                            code: errorCode,
+                            message: errorMsg,
+                        },
+                    });
+                    try {
+                        outputSseTransport.send(errorResp);
+                    }
+                    catch (sendErr) {
+                        logger.error(`Failed to send error response to session ${sessionId}:`, sendErr);
+                        delete sessions[sessionId];
+                    }
+                    return;
+                }
+                const response = wrapResponse(req, result.hasOwnProperty('error') ? { error: { ...result.error } } : { result: { ...result } });
+                logger.info(`Response (session ${sessionId}):`, response);
+                try {
+                    outputSseTransport.send(response);
+                }
+                catch (sendErr) {
+                    logger.error(`Failed to send response to session ${sessionId}:`, sendErr);
+                    delete sessions[sessionId];
+                }
+            }
+            else {
+                logger.info(`Input StreamableHttp → Output SSE (session ${sessionId}):`, message);
+                try {
+                    outputSseTransport.send(message);
+                }
+                catch (sendErr) {
+                    logger.error(`Failed to send message to session ${sessionId}:`, sendErr);
+                    delete sessions[sessionId];
+                }
+            }
+        };
+        outputSseTransport.onclose = () => {
+            logger.info(`Output SSE connection closed (session ${sessionId})`);
+            delete sessions[sessionId];
+        };
+        outputSseTransport.onerror = (err) => {
+            logger.error(`Output SSE error (session ${sessionId}):`, err);
+            delete sessions[sessionId];
+        };
+        req.on('close', () => {
+            logger.info(`Client disconnected (session ${sessionId})`);
+            delete sessions[sessionId];
+        });
+    });
+    app.post(messagePath, async (req, res) => {
+        const sessionId = req.query.sessionId;
+        setResponseHeaders({
+            res,
+            headers,
+        });
+        if (!sessionId) {
+            return res.status(400).send('Missing sessionId parameter');
+        }
+        const session = sessions[sessionId];
+        if (session?.transport?.handlePostMessage) {
+            logger.info(`POST to SSE transport (session ${sessionId})`);
+            await session.transport.handlePostMessage(req, res);
+        }
+        else {
+            res.status(503).send(`No active SSE connection for session ${sessionId}`);
+        }
+    });
+    app.listen(port, host, () => {
+        logger.info(`Listening on ${host}:${port}`);
+        logger.info(`SSE endpoint: http://${host}:${port}${ssePath}`);
+        logger.info(`POST messages: http://${host}:${port}${messagePath}`);
+    });
+    logger.info('StreamableHttp-to-SSE gateway ready');
+}
+//# sourceMappingURL=streamableHttpToSse.js.map

package/dist/gateways/streamableHttpToSse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamableHttpToSse.js","sourceRoot":"","sources":["../../src/gateways/streamableHttpToSse.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,IAA0B,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAO7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAepE,IAAI,oBAAwC,CAAC;AAE7C,MAAM,iCAAiC,GAAG,CAAC,EAAE,OAAO,EAA+B,EAAE,EAAE;IACrF,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,UAAwC,CAAC;IAC5E,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,YAA8C,CAAC;IAE1F,OAAO,IAAI,MAAM,CACf;QACE,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,SAAS;QACnC,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,UAAU,EAAE;KAC7C,EACD;QACE,YAAY,EAAE,kBAAkB,IAAI,EAAE;KACvC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,+BAA+B,GAAG,KAAK,EAAE,EAC7C,uBAAuB,GAGxB,EAAE,EAAE;IACH,MAAM,4BAA4B,GAAG,IAAI,MAAM,CAC7C;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,UAAU,EAAE;KACtB,EACD;QACE,YAAY,EAAE,EAAE;KACjB,CACF,CAAC;IAEF,MAAM,4BAA4B,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpE,OAAO,4BAA4B,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAA8D,EAAE,EAAE,CAC1G,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;IAC/C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAA6B;IACrE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,GAClH,IAAI,CAAC;IAEP,MAAM,CAAC,IAAI,CAAC,6BAA6B,iBAAiB,EAAE,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChG,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACjC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,IAAI,CAAC,aAAa,UAAU,CAAC,CAAC,CAAC,YAAY,mBAAmB,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACzG,MAAM,CAAC,IAAI,CAAC,yBAAyB,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEvG,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtB,MAAM,4BAA4B,GAAG,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,iBAAiB,CAAC,EAAE;QACjG,WAAW,EAAE;YACX,OAAO;SACR;KACF,CAAC,CAAC;IAEH,4BAA4B,CAAC,OAAO,GAAG,CAAC,GAAG,EAAE,EAAE;QAC7C,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC,CAAC;IAEF,4BAA4B,CAAC,OAAO,GAAG,GAAG,EAAE;QAC1C,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IAElG,MAAM,QAAQ,GAAkF,EAAE,CAAC;IAEnG,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,IAAI,UAAU,EAAE,CAAC;QACf,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,IAAI,EAAE,CAAC;QAC5C,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;QACjC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YACxB,kBAAkB,CAAC;gBACjB,GAAG;gBACH,OAAO;aACR,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAClC,MAAM,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAEjD,kBAAkB,CAAC;YACjB,GAAG;YACH,OAAO;SACR,CAAC,CAAC;QAEH,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,GAAG,OAAO,GAAG,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;QACnF,MAAM,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAE/C,MAAM,SAAS,GAAG,kBAAkB,CAAC,SAAS,CAAC;QAC/C,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QACzE,CAAC;QAED,MAAM,YAAY,GAAG,CAAC,GAAmB,EAAE,OAAe,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,KAAK;YAC7B,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,GAAG,OAAO;SACX,CAAC,CAAC;QAEH,kBAAkB,CAAC,SAAS,GAAG,KAAK,EAAE,OAAuB,EAAE,EAAE;YAC/D,MAAM,SAAS,GAAG,QAAQ,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC;YACzD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,8CAA8C,SAAS,IAAI,EAAE,OAAO,CAAC,CAAC;gBAClF,MAAM,GAAG,GAAG,OAAyB,CAAC;gBACtC,IAAI,MAAM,CAAC;gBAEX,IAAI,CAAC;oBACH,IAAI,CAAC,oBAAoB,EAAE,CAAC;wBAC1B,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;4BACpC,oBAAoB,GAAG,iCAAiC,CAAC;gCACvD,OAAO;6BACR,CAAC,CAAC;4BAEH,MAAM,eAAe,GAAG,oBAAoB,CAAC,OAAO,CAAC;4BAErD,oBAAoB,CAAC,OAAO,GAAG,KAAK,WAAW,cAAc,EAAE,GAAG,QAAQ;gCACxE,IACE,uBAAuB,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,OAAO;oCACzD,OAAO,CAAC,MAAM,EAAE,eAAe;oCAC/B,cAAc,CAAC,MAAM,EAAE,eAAe,EACtC,CAAC;oCACD,cAAc,CAAC,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;gCACzE,CAAC;gCAED,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,cAAc,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;gCAE1E,OAAO,MAAM,CAAC;4BAChB,CAAC,CAAC;4BAEF,MAAM,oBAAoB,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;4BACjE,oBAAoB,CAAC,OAAO,GAAG,eAAe,CAAC;wBACjD,CAAC;6BAAM,CAAC;4BACN,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;4BAC/E,oBAAoB,GAAG,MAAM,+BAA+B,CAAC;gCAC3D,uBAAuB,EAAE,4BAA4B;6BACtD,CAAC,CAAC;wBACL,CAAC;wBAED,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;oBAChD,CAAC;yBAAM,CAAC;wBACN,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;oBAC5D,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;oBACpC,MAAM,SAAS,GAAG,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,CAAE,GAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;oBAC/F,IAAI,QAAQ,GAAG,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,CAAC,CAAC,CAAE,GAAW,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;oBAC5G,MAAM,MAAM,GAAG,aAAa,SAAS,GAAG,CAAC;oBACzC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;wBAChC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;oBAClD,CAAC;oBACD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE;wBAClC,KAAK,EAAE;4BACL,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,QAAQ;yBAClB;qBACF,CAAC,CAAC;oBACH,IAAI,CAAC;wBACH,kBAAkB,CAAC,IAAI,CAAC,SAAgB,CAAC,CAAC;oBAC5C,CAAC;oBAAC,OAAO,OAAO,EAAE,CAAC;wBACjB,MAAM,CAAC,KAAK,CAAC,4CAA4C,SAAS,GAAG,EAAE,OAAO,CAAC,CAAC;wBAChF,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;oBAC7B,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,MAAM,QAAQ,GAAG,YAAY,CAC3B,GAAG,EACH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAC5F,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,qBAAqB,SAAS,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC1D,IAAI,CAAC;oBACH,kBAAkB,CAAC,IAAI,CAAC,QAAe,CAAC,CAAC;gBAC3C,CAAC;gBAAC,OAAO,OAAO,EAAE,CAAC;oBACjB,MAAM,CAAC,KAAK,CAAC,sCAAsC,SAAS,GAAG,EAAE,OAAO,CAAC,CAAC;oBAC1E,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,8CAA8C,SAAS,IAAI,EAAE,OAAO,CAAC,CAAC;gBAClF,IAAI,CAAC;oBACH,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnC,CAAC;gBAAC,OAAO,OAAO,EAAE,CAAC;oBACjB,MAAM,CAAC,KAAK,CAAC,qCAAqC,SAAS,GAAG,EAAE,OAAO,CAAC,CAAC;oBACzE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,kBAAkB,CAAC,OAAO,GAAG,GAAG,EAAE;YAChC,MAAM,CAAC,IAAI,CAAC,yCAAyC,SAAS,GAAG,CAAC,CAAC;YACnE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,kBAAkB,CAAC,OAAO,GAAG,CAAC,GAAG,EAAE,EAAE;YACnC,MAAM,CAAC,KAAK,CAAC,6BAA6B,SAAS,IAAI,EAAE,GAAG,CAAC,CAAC;YAC9D,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,MAAM,CAAC,IAAI,CAAC,gCAAgC,SAAS,GAAG,CAAC,CAAC;YAC1D,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,GAAQ,EAAE,GAAQ,EAAE,EAAE;QACjD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAAmB,CAAC;QAEhD,kBAAkB,CAAC;YACjB,GAAG;YACH,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,kCAAkC,SAAS,GAAG,CAAC,CAAC;YAC5D,MAAM,OAAO,CAAC,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,wCAAwC,SAAS,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,wBAAwB,IAAI,IAAI,IAAI,GAAG,OAAO,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,yBAAyB,IAAI,IAAI,IAAI,GAAG,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;AACrD,CAAC"}

package/dist/gateways/streamableHttpToStdio.d.ts

@@ -0,0 +1,8 @@
+import { Logger } from '../types.js';
+export interface StreamableHttpToStdioArgs {
+    streamableHttpUrl: string;
+    logger: Logger;
+    headers: Record<string, string>;
+}
+export declare function streamableHttpToStdio(args: StreamableHttpToStdioArgs): Promise<void>;
+//# sourceMappingURL=streamableHttpToStdio.d.ts.map

package/dist/gateways/streamableHttpToStdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamableHttpToStdio.d.ts","sourceRoot":"","sources":["../../src/gateways/streamableHttpToStdio.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAkCD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,iBAgH1E"}

package/dist/gateways/streamableHttpToStdio.js

@@ -0,0 +1,124 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { InitializeRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { getVersion } from '../lib/getVersion.js';
+import { onSignals } from '../lib/onSignals.js';
+let mcpClient;
+const newInitializeMcpClient = ({ message }) => {
+    const clientInfo = message.params?.clientInfo;
+    const clientCapabilities = message.params?.capabilities;
+    return new Client({
+        name: clientInfo?.name ?? 'mcp-nyx',
+        version: clientInfo?.version ?? getVersion(),
+    }, {
+        capabilities: clientCapabilities ?? {},
+    });
+};
+const newFallbackMcpClient = async ({ mcpTransport }) => {
+    const fallbackMcpClient = new Client({
+        name: 'mcp-nyx',
+        version: getVersion(),
+    }, {
+        capabilities: {},
+    });
+    await fallbackMcpClient.connect(mcpTransport);
+    return fallbackMcpClient;
+};
+export async function streamableHttpToStdio(args) {
+    const { streamableHttpUrl, logger, headers } = args;
+    logger.info(`  - streamableHttp: ${streamableHttpUrl}`);
+    logger.info(`  - Headers: ${Object.keys(headers).length ? JSON.stringify(headers) : '(none)'}`);
+    logger.info('Connecting to Streamable HTTP...');
+    onSignals({ logger });
+    const mcpTransport = new StreamableHTTPClientTransport(new URL(streamableHttpUrl), {
+        requestInit: {
+            headers,
+        },
+    });
+    mcpTransport.onerror = (err) => {
+        logger.error('Streamable HTTP error:', err);
+    };
+    mcpTransport.onclose = () => {
+        logger.error('Streamable HTTP connection closed');
+        process.exit(1);
+    };
+    const stdioServer = new Server({
+        name: 'mcp-nyx',
+        version: getVersion(),
+    }, {
+        capabilities: {},
+    });
+    const stdioTransport = new StdioServerTransport();
+    await stdioServer.connect(stdioTransport);
+    const wrapResponse = (req, payload) => ({
+        jsonrpc: req.jsonrpc || '2.0',
+        id: req.id,
+        ...payload,
+    });
+    stdioServer.transport.onmessage = async (message) => {
+        const isRequest = 'method' in message && 'id' in message;
+        if (isRequest) {
+            logger.info('Stdio → Streamable HTTP:', message);
+            const req = message;
+            let result;
+            try {
+                if (!mcpClient) {
+                    if (message.method === 'initialize') {
+                        mcpClient = newInitializeMcpClient({
+                            message,
+                        });
+                        const originalRequest = mcpClient.request;
+                        mcpClient.request = async function (possibleInitRequestMessage, ...restArgs) {
+                            if (InitializeRequestSchema.safeParse(possibleInitRequestMessage).success &&
+                                message.params?.protocolVersion) {
+                                // respect the protocol version from the stdio client's init request
+                                possibleInitRequestMessage.params.protocolVersion = message.params.protocolVersion;
+                            }
+                            result = await originalRequest.apply(this, [possibleInitRequestMessage, ...restArgs]);
+                            return result;
+                        };
+                        await mcpClient.connect(mcpTransport);
+                        mcpClient.request = originalRequest;
+                    }
+                    else {
+                        logger.info('Streamable HTTP client not initialized, creating fallback client');
+                        mcpClient = await newFallbackMcpClient({ mcpTransport });
+                    }
+                    logger.info('Streamable HTTP connected');
+                }
+                else {
+                    result = await mcpClient.request(req, z.any());
+                }
+            }
+            catch (err) {
+                logger.error('Request error:', err);
+                const errorCode = err && typeof err === 'object' && 'code' in err ? err.code : -32000;
+                let errorMsg = err && typeof err === 'object' && 'message' in err ? err.message : 'Internal error';
+                const prefix = `MCP error ${errorCode}:`;
+                if (errorMsg.startsWith(prefix)) {
+                    errorMsg = errorMsg.slice(prefix.length).trim();
+                }
+                const errorResp = wrapResponse(req, {
+                    error: {
+                        code: errorCode,
+                        message: errorMsg,
+                    },
+                });
+                process.stdout.write(JSON.stringify(errorResp) + '\n');
+                return;
+            }
+            const response = wrapResponse(req, result.hasOwnProperty('error') ? { error: { ...result.error } } : { result: { ...result } });
+            logger.info('Response:', response);
+            process.stdout.write(JSON.stringify(response) + '\n');
+        }
+        else {
+            logger.info('Streamable HTTP → Stdio:', message);
+            process.stdout.write(JSON.stringify(message) + '\n');
+        }
+    };
+    logger.info('Stdio server listening');
+}
+//# sourceMappingURL=streamableHttpToStdio.js.map

package/dist/gateways/streamableHttpToStdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamableHttpToStdio.js","sourceRoot":"","sources":["../../src/gateways/streamableHttpToStdio.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+/**
+ * index.ts
+ *
+ * Run MCP stdio servers over SSE, convert between stdio, SSE, WS.
+ *
+ * Usage:
+ *   # stdio→SSE
+ *   npx -y @alsania-io/mcpnyx --stdio "npx -y @modelcontextprotocol/server-filesystem /" \
+ *                       --port 3006 --baseUrl http://localhost:3006 --ssePath /sse --messagePath /message
+ *
+ *   # SSE→stdio
+ *   npx -y @alsania-io/mcpnyx --sse "https://mcp-server-ab71a6b2-cd55-49d0-adba-562bc85956e3.supermachine.app"
+ *
+ *   # SSE→SSE
+ *   npx -y @alsania-io/mcpnyx --sse "https://input-sse-server.example.com/sse" --outputTransport ssetosse \
+ *                       --port 3006 --baseUrl http://localhost:3006 --ssePath /sse --messagePath /message
+ *
+ *   # SSE→WS
+ *   npx -y @alsania-io/mcpnyx --sse "https://input-sse-server.example.com/sse" --outputTransport ws \
+ *                       --port 3006 --messagePath /message
+ *
+ *   # stdio→WS
+ *   npx -y @alsania-io/mcpnyx --stdio "npx -y @modelcontextprotocol/server-filesystem /" --outputTransport ws
+ *
+ *   # Streamable HTTP→stdio
+ *   npx -y @alsania-io/mcpnyx --streamableHttp "https://mcp-server.example.com/mcp"
+ *
+ *   # Streamable HTTP→SSE
+ *   npx -y @alsania-io/mcpnyx --streamableHttp "https://mcp-server.example.com/mcp" --outputTransport sse \
+ *                       --port 3006 --baseUrl http://localhost:3006 --ssePath /sse --messagePath /message
+ *
+ *   # Config→SSE (unified multiple servers)
+ *   npx -y @alsania-io/mcpnyx --config ./config.json --outputTransport sse --port 3006
+ *
+ *   # Config→WS (unified multiple servers)
+ *   npx -y @alsania-io/mcpnyx --config ./config.json --outputTransport ws --port 3006
+ *
+ *   # Config→StreamableHttp (unified multiple servers - stateless)
+ *   npx -y @alsania-io/mcpnyx --config ./config.json --outputTransport streamableHttp --port 3006
+ *
+ *   # Config→StreamableHttp (unified multiple servers - stateful with session timeout)
+ *   npx -y @alsania-io/mcpnyx --config ./config.json --outputTransport streamableHttp --port 3006 --stateful --sessionTimeout 300000
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG"}