feat: rename /stream to /mcp to align with common conventions

BREAKING CHANGE: /stream renamed to /mcp

Author: punkpeye

README.md

@@ -25,14 +25,14 @@ npm install mcp-proxy
 npx mcp-proxy --port 8080 --shell tsx server.js
 ```
 
-This starts a server and `stdio` server (`tsx server.js`). The server listens on port 8080 and `/stream` (streamable HTTP) and `/sse` (SSE) endpoints, and forwards messages to the `stdio` server.
+This starts a server and `stdio` server (`tsx server.js`). The server listens on port 8080 and `/mcp` (streamable HTTP) and `/sse` (SSE) endpoints, and forwards messages to the `stdio` server.
 
 options:
 
 - `--server`: Set to `sse` or `stream` to only enable the respective transport (default: both)
-- `--endpoint`: If `server` is set to `sse` or `stream`, this option sets the endpoint path (default: `/sse` or `/stream`)
+- `--endpoint`: If `server` is set to `sse` or `stream`, this option sets the endpoint path (default: `/sse` or `/mcp`)
 - `--sseEndpoint`: Set the SSE endpoint path (default: `/sse`). Overrides `--endpoint` if `server` is set to `sse`.
-- `--streamEndpoint`: Set the streamable HTTP endpoint path (default: `/stream`). Overrides `--endpoint` if `server` is set to `stream`.
+- `--streamEndpoint`: Set the streamable HTTP endpoint path (default: `/mcp`). Overrides `--endpoint` if `server` is set to `stream`.
 - `--port`: Specify the port to listen on (default: 8080)
 - `--debug`: Enable debug logging
 - `--shell`: Spawn the server via the user's shell

src/bin/mcp-proxy.ts

@@ -65,7 +65,7 @@ const argv = await yargs(hideBin(process.argv))
       type: "string",
     },
     streamEndpoint: {
-      default: "/stream",
+      default: "/mcp",
       describe: "The stream endpoint to listen on",
       type: "string",
     },

src/startHTTPServer.test.ts

@@ -78,7 +78,7 @@ it("proxies messages between HTTP stream and stdio servers", async () => {
   );
 
   const transport = new StreamableHTTPClientTransport(
-    new URL(`http://localhost:${port}/stream`),
+    new URL(`http://localhost:${port}/mcp`),
   );
 
   await streamClient.connect(transport);

src/startHTTPServer.ts

@@ -431,7 +431,7 @@ export const startHTTPServer = async <T extends ServerLike>({
       await handleStreamRequest({
         activeTransports: activeStreamTransports,
         createServer,
-        endpoint: streamEndpoint ?? "/stream",
+        endpoint: streamEndpoint ?? "/mcp",
         eventStore,
         onClose,
         onConnect,