@luutuankiet/mcp-proxy-shim 1.0.7 → 1.1.0-dev.1

package/dist/http-server.js

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+/**
+ * MCP Proxy Shim — HTTP Streamable Server Entry Point
+ *
+ * Runs the schema-transforming MCP proxy as an HTTP Streamable server.
+ * Remote agents connect via HTTP POST/GET/DELETE to /mcp.
+ *
+ * Architecture:
+ *   Remote Agent  ──HTTP──▶  this server (:3000/mcp)  ──HTTP──▶  mcpproxy-go (upstream)
+ *
+ * Each downstream client session gets its own MCP Server + Transport pair,
+ * but they all share a SINGLE upstream mcpproxy-go connection (module-level
+ * state in core.ts). This is efficient: one upstream session, many downstream.
+ *
+ * Environment variables:
+ *   MCP_URL      (required)  Upstream mcpproxy-go StreamableHTTP endpoint
+ *   MCP_PORT     (optional)  Port to listen on (default: 3000)
+ *   MCP_HOST     (optional)  Host to bind to (default: 0.0.0.0)
+ *   MCP_APIKEY   (optional)  API key for downstream clients. When set, requests
+ *                            must include ?apikey=KEY in the URL. Unset = open.
+ *   https_proxy  (optional)  HTTPS proxy for upstream connection
+ *
+ * Usage:
+ *   MCP_URL="https://mcpproxy.kenluu.org/mcp/?apikey=KEY" npx @luutuankiet/mcp-proxy-shim-http
+ *
+ * Then point your MCP client at:
+ *   http://localhost:3000/mcp
+ *
+ * For production, put a reverse proxy (Caddy/nginx) in front for TLS:
+ *   https://shim.yourdomain.com/mcp  ──▶  http://localhost:3000/mcp
+ */
+import { randomUUID } from "node:crypto";
+import http from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { createShimServer, log, maskUrl, UPSTREAM_URL } from "./core.js";
+const PORT = parseInt(process.env.MCP_PORT || "3000", 10);
+const HOST = process.env.MCP_HOST || "0.0.0.0";
+const APIKEY = process.env.MCP_APIKEY || null;
+// ---------------------------------------------------------------------------
+// Session management
+// ---------------------------------------------------------------------------
+// Each downstream client gets its own MCP Server + Transport pair.
+// All of them share the SAME upstream mcpproxy-go session (module-level in core.ts).
+const transports = new Map();
+/**
+ * Create a new downstream session: fresh Server + Transport pair.
+ * The upstream connection is shared via core.ts module state.
+ */
+async function createSessionTransport() {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+        onsessioninitialized: (sessionId) => {
+            log(`HTTP session initialized: ${sessionId.slice(0, 12)}...`);
+            transports.set(sessionId, transport);
+        },
+    });
+    transport.onclose = () => {
+        const sid = transport.sessionId;
+        if (sid && transports.has(sid)) {
+            log(`HTTP session closed: ${sid.slice(0, 12)}...`);
+            transports.delete(sid);
+        }
+    };
+    // Each session gets its own shim server with lazy upstream init.
+    // core.ts ensures the upstream session is shared (module-level singleton).
+    const server = await createShimServer({ lazyInit: true });
+    await server.connect(transport);
+    return transport;
+}
+// ---------------------------------------------------------------------------
+// HTTP request handler
+// ---------------------------------------------------------------------------
+function parseBody(req) {
+    return new Promise((resolve) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => {
+            try {
+                const raw = Buffer.concat(chunks).toString("utf-8");
+                resolve(raw ? JSON.parse(raw) : null);
+            }
+            catch {
+                resolve(null);
+            }
+        });
+        req.on("error", () => resolve(null));
+    });
+}
+async function handleMcpRequest(req, res) {
+    // CORS headers for browser-based clients
+    res.setHeader("Access-Control-Allow-Origin", "*");
+    res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type, Mcp-Session-Id, Last-Event-ID");
+    res.setHeader("Access-Control-Expose-Headers", "Mcp-Session-Id");
+    if (req.method === "OPTIONS") {
+        res.writeHead(204);
+        res.end();
+        return;
+    }
+    const sessionId = req.headers["mcp-session-id"];
+    try {
+        if (req.method === "POST") {
+            const body = await parseBody(req);
+            if (sessionId && transports.has(sessionId)) {
+                // Existing session
+                const transport = transports.get(sessionId);
+                await transport.handleRequest(req, res, body);
+            }
+            else if (!sessionId && isInitializeRequest(body)) {
+                // New client — create session
+                const transport = await createSessionTransport();
+                await transport.handleRequest(req, res, body);
+            }
+            else {
+                res.writeHead(400, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({
+                    jsonrpc: "2.0",
+                    error: { code: -32000, message: "Bad Request: No valid session ID provided" },
+                    id: null,
+                }));
+            }
+        }
+        else if (req.method === "GET") {
+            // SSE stream reconnection
+            if (!sessionId || !transports.has(sessionId)) {
+                res.writeHead(400, { "Content-Type": "text/plain" });
+                res.end("Invalid or missing session ID");
+                return;
+            }
+            const lastEventId = req.headers["last-event-id"];
+            if (lastEventId) {
+                log(`Client reconnecting with Last-Event-ID: ${lastEventId}`);
+            }
+            const transport = transports.get(sessionId);
+            await transport.handleRequest(req, res);
+        }
+        else if (req.method === "DELETE") {
+            // Session termination
+            if (!sessionId || !transports.has(sessionId)) {
+                res.writeHead(400, { "Content-Type": "text/plain" });
+                res.end("Invalid or missing session ID");
+                return;
+            }
+            log(`Session termination request: ${sessionId.slice(0, 12)}...`);
+            const transport = transports.get(sessionId);
+            await transport.handleRequest(req, res);
+        }
+        else {
+            res.writeHead(405, { "Content-Type": "text/plain" });
+            res.end("Method Not Allowed");
+        }
+    }
+    catch (error) {
+        log("HTTP handler error:", error.message);
+        if (!res.headersSent) {
+            res.writeHead(500, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({
+                jsonrpc: "2.0",
+                error: { code: -32603, message: "Internal server error" },
+                id: null,
+            }));
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Server startup
+// ---------------------------------------------------------------------------
+async function main() {
+    log(`Starting HTTP Streamable server on ${HOST}:${PORT}`);
+    log(`Upstream: ${maskUrl(UPSTREAM_URL)}`);
+    log(`Auth: ${APIKEY ? "apikey required (?apikey=...)" : "OPEN (no MCP_APIKEY set)"}`);
+    const httpServer = http.createServer((req, res) => {
+        const url = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
+        if (url.pathname === "/mcp" || url.pathname === "/mcp/") {
+            // Apikey gate — reject early if MCP_APIKEY is set and key doesn't match
+            if (APIKEY && url.searchParams.get("apikey") !== APIKEY) {
+                res.writeHead(401, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({
+                    jsonrpc: "2.0",
+                    error: { code: -32001, message: "Unauthorized: invalid or missing apikey" },
+                    id: null,
+                }));
+                return;
+            }
+            handleMcpRequest(req, res).catch((err) => {
+                log("Unhandled error in MCP handler:", err.message);
+                if (!res.headersSent) {
+                    res.writeHead(500);
+                    res.end("Internal Server Error");
+                }
+            });
+        }
+        else if (url.pathname === "/health" || url.pathname === "/healthz") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({
+                status: "ok",
+                sessions: transports.size,
+                uptime: process.uptime(),
+            }));
+        }
+        else {
+            res.writeHead(404, { "Content-Type": "text/plain" });
+            res.end("Not Found — MCP endpoint is at /mcp");
+        }
+    });
+    httpServer.listen(PORT, HOST, () => {
+        log(`HTTP Streamable server listening on http://${HOST}:${PORT}/mcp`);
+        log(`Health check: http://${HOST}:${PORT}/health`);
+        log("Waiting for MCP client connections...");
+    });
+    // Graceful shutdown
+    const shutdown = async () => {
+        log("Shutting down HTTP server...");
+        for (const [sid, transport] of transports) {
+            try {
+                log(`Closing session ${sid.slice(0, 12)}...`);
+                await transport.close();
+            }
+            catch (err) {
+                log(`Error closing session ${sid.slice(0, 12)}:`, err.message);
+            }
+        }
+        transports.clear();
+        httpServer.close(() => {
+            log("HTTP server stopped");
+            process.exit(0);
+        });
+        setTimeout(() => process.exit(1), 5000).unref();
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+main().catch((err) => {
+    log("Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

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

package/dist/index.d.ts

@@ -1,28 +1,20 @@
 #!/usr/bin/env node
 /**
- * MCP Stdio Shim
+ * MCP Proxy Shim — Unified Entry Point
  *
- * A schema-transforming MCP proxy that sits between Claude Code (stdio)
- * and mcpproxy-go (StreamableHTTP).
- *
- * What it does:
- *   - Passes through ALL upstream tools unchanged (retrieve_tools, upstream_servers, etc.)
- *   - Transforms call_tool_read / call_tool_write / call_tool_destructive schemas:
- *     upstream args_json:string → downstream args:object
- *   - On tool call: serializes args back to args_json before forwarding upstream
- *
- * Why not use SDK StreamableHTTPClientTransport:
- *   - Bug #396: 2nd callTool times out (broken session multiplexing)
- *   - We use plain fetch for upstream — reliable, simple, zero SDK client bugs
- *
- * Why low-level Server class (not McpServer):
- *   - Bug #893: McpServer.registerTool() breaks dynamic registration post-connect
- *   - Low-level Server.setRequestHandler() works correctly
+ * Subcommands:
+ *   (default)  stdio transport — for local MCP clients (Claude Code, Cursor, etc.)
+ *   serve      HTTP Streamable transport — for remote agents over HTTP
  *
  * Usage:
+ *   # Stdio mode (default)
  *   MCP_URL="https://proxy.example.com/mcp/?apikey=KEY" npx @luutuankiet/mcp-proxy-shim
  *
- * .mcp.json entry:
+ *   # HTTP server mode
+ *   MCP_URL="https://proxy.example.com/mcp/?apikey=KEY" npx @luutuankiet/mcp-proxy-shim serve
+ *   MCP_URL="..." MCP_PORT=8080 npx @luutuankiet/mcp-proxy-shim serve
+ *
+ * .mcp.json entry (stdio):
  *   { "mcpServers": { "proxy": { "type": "stdio", "command": "npx", "args": ["-y", "@luutuankiet/mcp-proxy-shim"], "env": { "MCP_URL": "..." } } } }
  */
 export {};