mcp-stdio-to-sse-wrapper

# MCP STDIO to SSE Wrapper A Docker container that wraps any Model Context Protocol (MCP) server with an SSE interface. ## Features - Converts any stdio-based MCP server to an SSE interface - Works with both Node.js and Python-based MCP servers - Customizable port, SSE path, and message path - Ready to use with Kubernetes ## Docker Image Available on Docker Hub: [macmee/mcp-stdio-to-sse-wrapper](https://hub.docker.com/r/macmee/mcp-stdio-to-sse-wrapper) ## Usage ### Basic Usage with Brave Search ```bash docker run --rm -it -p 8080:8080 \ -e BRAVE_API_KEY="your-api-key" \ macmee/mcp-stdio-to-sse-wrapper ``` ### With Other MCP Servers ```bash # For Node.js-based MCP servers docker run --rm -it -p 8080:8080 \ -e MCP_SERVER_TO_WRAP="npx @modelcontextprotocol/server-some-other-mcp" \ macmee/mcp-stdio-to-sse-wrapper # For Python-based MCP servers docker run --rm -it -p 8080:8080 \ -e MCP_SERVER_TO_WRAP="uv run mcp-server-name" \ macmee/mcp-stdio-to-sse-wrapper ``` ## Environment Variables | Variable | Default | Description | |----------|---------|-------------| | `MCP_SERVER_TO_WRAP` | `npx @modelcontextprotocol/server-brave-search` | Command to run the MCP server | | `PORT` | `8080` | Port to listen on | | `SSE_PATH` | `/sse` | Path for SSE connections | | `MESSAGE_PATH` | `/message` | Path for message processing | | `BASE_URL` | `http://localhost:$PORT` | Base URL for the server | ## Kubernetes Example ```yaml apiVersion: apps/v1 kind: Deployment metadata: name: mcp-server labels: app: mcp-server spec: replicas: 1 selector: matchLabels: app: mcp-server template: metadata: labels: app: mcp-server spec: containers: - name: mcp-server image: macmee/mcp-stdio-to-sse-wrapper:latest ports: - containerPort: 8080 env: - name: MCP_SERVER_TO_WRAP value: "npx @modelcontextprotocol/server-brave-search" - name: BRAVE_API_KEY valueFrom: secretKeyRef: name: mcp-secrets key: brave-api-key --- apiVersion: v1 kind: Service metadata: name: mcp-server spec: selector: app: mcp-server ports: - port: 80 targetPort: 8080 type: ClusterIP ``` ## License MIT