update stderr option and readme

Author: zhjch05

README.md

@@ -61,6 +61,14 @@ mcp-server-metamcp --metamcp-api-key <your-api-key> --transport sse --port 12006
 
 With the SSE transport option, the server will start an Express.js web server that listens for SSE connections on the `/sse` endpoint and accepts messages on the `/messages` endpoint.
 
+### Using as a Streamable HTTP server
+
+```bash
+mcp-server-metamcp --metamcp-api-key <your-api-key> --transport streamable-http --port 12006
+```
+
+With the Streamable HTTP transport option, the server will start an Express.js web server that handles HTTP requests. You can optionally use `--stateless` mode for stateless operation.
+
 ### Using with Docker
 
 When running the server inside a Docker container and connecting to services on the host machine, use the `--use-docker-host` option to automatically transform localhost URLs:
@@ -71,17 +79,40 @@ mcp-server-metamcp --metamcp-api-key <your-api-key> --transport sse --port 12006
 
 This will transform any localhost or 127.0.0.1 URLs to `host.docker.internal`, allowing the container to properly connect to services running on the host.
 
+### Configuring stderr handling
+
+For STDIO transport, you can control how stderr is handled from child MCP processes:
+
+```bash
+# Use inherit to see stderr output from child processes
+mcp-server-metamcp --metamcp-api-key <your-api-key> --stderr inherit
+
+# Use pipe to capture stderr (default is ignore)
+mcp-server-metamcp --metamcp-api-key <your-api-key> --stderr pipe
+
+# Or set via environment variable
+METAMCP_STDERR=inherit mcp-server-metamcp --metamcp-api-key <your-api-key>
+```
+
+Available stderr options:
+- `ignore` (default): Ignore stderr output from child processes
+- `inherit`: Pass through stderr from child processes to the parent
+- `pipe`: Capture stderr in a pipe for processing
+- `overlapped`: Use overlapped I/O (Windows-specific)
+
 ### Command Line Options
 
 ```
 Options:
   --metamcp-api-key <key>       API key for MetaMCP (can also be set via METAMCP_API_KEY env var)
   --metamcp-api-base-url <url>  Base URL for MetaMCP API (can also be set via METAMCP_API_BASE_URL env var)
   --report                      Fetch all MCPs, initialize clients, and report tools to MetaMCP API
-  --transport <type>            Transport type to use (stdio or sse) (default: "stdio")
-  --port <port>                 Port to use for SSE transport (default: "12006")
-  --require-api-auth            Require API key in SSE URL path
+  --transport <type>            Transport type to use (stdio, sse, or streamable-http) (default: "stdio")
+  --port <port>                 Port to use for SSE or Streamable HTTP transport, defaults to 12006 (default: "12006")
+  --require-api-auth            Require API key in SSE or Streamable HTTP URL path
+  --stateless                   Use stateless mode for Streamable HTTP transport
   --use-docker-host             Transform localhost URLs to use host.docker.internal (can also be set via USE_DOCKER_HOST env var)
+  --stderr <type>               Stderr handling for STDIO transport (overlapped, pipe, ignore, inherit) (default: "ignore")
   -h, --help                    display help for command
 ```
 
@@ -90,6 +121,7 @@ Options:
 - `METAMCP_API_KEY`: API key for MetaMCP
 - `METAMCP_API_BASE_URL`: Base URL for MetaMCP API
 - `USE_DOCKER_HOST`: When set to "true", transforms localhost URLs to host.docker.internal for Docker compatibility
+- `METAMCP_STDERR`: Stderr handling for STDIO transport (overlapped, pipe, ignore, inherit). Defaults to "ignore"
 
 ## Development
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamcp/mcp-server-metamcp",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "MCP Server MetaMCP manages all your other MCPs in one MCP.",
   "scripts": {
     "build": "tsc && shx chmod +x dist/*.js",

package.json

@@ -6,7 +6,7 @@ import {
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
-import { ServerParameters } from "./fetch-metamcp.js";
+import { ServerParameters, IOType } from "./fetch-metamcp.js";
 
 const sleep = (time: number) =>
   new Promise<void>((resolve) => setTimeout(() => resolve(), time));
@@ -33,11 +33,17 @@ export const createMetaMcpClient = (
   // Create the appropriate transport based on server type
   // Default to "STDIO" if type is undefined
   if (!serverParams.type || serverParams.type === "STDIO") {
+    // Get stderr value from serverParams, environment variable, or default to "ignore"
+    const stderrValue: IOType = 
+      serverParams.stderr || 
+      (process.env.METAMCP_STDERR as IOType) || 
+      "ignore";
+
     const stdioParams: StdioServerParameters = {
       command: serverParams.command || "",
       args: serverParams.args || undefined,
       env: serverParams.env || undefined,
-      stderr: "ignore",
+      stderr: stderrValue,
     };
     transport = new StdioClientTransport(stdioParams);
   } else if (serverParams.type === "SSE" && serverParams.url) {
@@ -85,7 +91,7 @@ export const createMetaMcpClient = (
   const client = new Client(
     {
       name: "MetaMCP",
-      version: "0.6.0",
+      version: "0.6.1",
     },
     {
       capabilities: {

src/client.ts

@@ -5,6 +5,9 @@ import {
   getMetaMcpApiKey,
 } from "./utils.js";
 
+// Define IOType for stderr handling
+export type IOType = "overlapped" | "pipe" | "ignore" | "inherit";
+
 // Define a new interface for server parameters that can be STDIO, SSE or STREAMABLE_HTTP
 export interface ServerParameters {
   uuid: string;
@@ -14,6 +17,7 @@ export interface ServerParameters {
   command?: string | null;
   args?: string[] | null;
   env?: Record<string, string> | null;
+  stderr?: IOType; // Optional field for stderr handling, defaults to "ignore"
   url?: string | null;
   created_at: string;
   profile_uuid: string;

src/fetch-metamcp.ts

@@ -7,6 +7,7 @@ import { reportAllTools } from "./report-tools.js";
 import { cleanupAllSessions } from "./sessions.js";
 import { startSSEServer } from "./sse.js";
 import { startStreamableHTTPServer } from "./streamable-http.js";
+import { IOType } from "./fetch-metamcp.js";
 
 const program = new Command();
 
@@ -33,10 +34,22 @@ program
     "--use-docker-host",
     "Transform localhost URLs to use host.docker.internal (can also be set via USE_DOCKER_HOST env var)"
   )
+  .option(
+    "--stderr <type>",
+    "Stderr handling for STDIO transport (overlapped, pipe, ignore, inherit)",
+    "ignore"
+  )
   .parse(process.argv);
 
 const options = program.opts();
 
+// Validate stderr option
+const validStderrTypes: IOType[] = ["overlapped", "pipe", "ignore", "inherit"];
+if (!validStderrTypes.includes(options.stderr as IOType)) {
+  console.error(`Invalid stderr type: ${options.stderr}. Must be one of: ${validStderrTypes.join(", ")}`);
+  process.exit(1);
+}
+
 // Set environment variables from command line arguments
 if (options.metamcpApiKey) {
   process.env.METAMCP_API_KEY = options.metamcpApiKey;
@@ -47,6 +60,9 @@ if (options.metamcpApiBaseUrl) {
 if (options.useDockerHost) {
   process.env.USE_DOCKER_HOST = "true";
 }
+if (options.stderr) {
+  process.env.METAMCP_STDERR = options.stderr;
+}
 
 async function main() {
   // If --report flag is set, run the reporting function instead of starting the server

src/index.ts

@@ -40,7 +40,7 @@ export const createServer = async () => {
   const server = new Server(
     {
       name: "MetaMCP",
-      version: "0.6.0",
+      version: "0.6.1",
     },
     {
       capabilities: {