mcp-proxy 6.2.0 → 6.3.0

package/README.md

@@ -60,6 +60,31 @@ options:
 - `--sslCa`: Filename to override the trusted CA certificates
 - `--sslCert`: Cert chains filename in PEM format
 - `--sslKey`: Private keys filename in PEM format
+- `--tunnel`: Expose the proxy via a public tunnel (see [Public Tunnel](#public-tunnel))
+- `--tunnelSubdomain`: Request a specific subdomain for the tunnel (availability not guaranteed)
+
+### Public Tunnel
+
+MCP Proxy can expose your local server to the public internet using a tunnel service. This is useful for testing webhooks, sharing your development server, or accessing your MCP server from anywhere.
+
+```bash
+# Expose your MCP server via a public tunnel
+npx mcp-proxy --port 8080 --tunnel -- tsx server.js
+
+# Request a specific subdomain
+npx mcp-proxy --port 8080 --tunnel --tunnelSubdomain myapp -- tsx server.js
+```
+
+When the tunnel is established, you'll see a message like:
+
+```
+tunnel established at https://abcdefghij.tunnel.gla.ma
+```
+
+> [!NOTE]
+> The requested subdomain may not be available. The actual URL will be displayed when the tunnel is established.
+
+This feature is powered by [pipenet](https://github.com/AugmentHQ/pipenet) and sponsored by [glama.ai](https://glama.ai). For more information, see the [pipenet announcement](https://glama.ai/blog/2026-01-19-pipenet).
 
 ### Stateless Mode
 

package/dist/bin/mcp-proxy.mjs

@@ -6,6 +6,7 @@ import { format, inspect } from "util";
 import { readFileSync, readdirSync, statSync, writeFile } from "fs";
 import { setTimeout as setTimeout$1 } from "node:timers";
 import util from "node:util";
+import { pipenet } from "pipenet";
 import { notStrictEqual, strictEqual } from "assert";
 import { fileURLToPath } from "url";
 import { readFileSync as readFileSync$1, readdirSync as readdirSync$1 } from "node:fs";
@@ -5095,6 +5096,15 @@ const argv = await yargs_default(hideBin(process.argv)).scriptName("mcp-proxy").
 		default: "/mcp",
 		describe: "The stream endpoint to listen on",
 		type: "string"
+	},
+	tunnel: {
+		default: false,
+		describe: "Expose the proxy via a public tunnel using tunnel.gla.ma",
+		type: "boolean"
+	},
+	tunnelSubdomain: {
+		describe: "Request a specific subdomain for the tunnel (availability not guaranteed)",
+		type: "string"
 	}
 }).help().parseAsync();
 const dashDashArgs = argv["--"];
@@ -5159,8 +5169,19 @@ const proxy = async () => {
 		stateless: argv.stateless,
 		streamEndpoint: argv.server && argv.server !== "stream" ? null : argv.streamEndpoint ?? argv.endpoint
 	});
-	return { close: () => {
-		return server.close();
+	let tunnel;
+	if (argv.tunnel) {
+		console.info("establishing tunnel via tunnel.gla.ma");
+		tunnel = await pipenet({
+			host: "https://tunnel.gla.ma",
+			port: argv.port,
+			subdomain: argv.tunnelSubdomain
+		});
+		console.info("tunnel established at %s", tunnel.url);
+	}
+	return { close: async () => {
+		await server.close();
+		if (tunnel) await tunnel.close();
 	} };
 };
 const createGracefulShutdown = ({ server, timeout }) => {