MCP Stdio To Sse Wrapper

🚀 MCP Standard Input to SSE Wrapper

A Docker container that wraps any Model Context Protocol (MCP) server into a form with an SSE interface.

🚀 Quick Start

This Docker container can transform any standard input-based MCP server into an SSE interface. It supports MCP servers based on Node.js and Python, and allows customizing ports, SSE paths, and message paths. It's also ready for use in Kubernetes.

✨ Features

• Convert any standard input-based MCP server to an SSE interface.
• Support Node.js and Python-based MCP servers.
• Customize ports, SSE paths, and message paths.
• Ready for Kubernetes usage.

📦 Docker Image

Available on Docker Hub: macmee/mcp-stdio-to-sse-wrapper

💻 Usage Examples

Basic Usage (Taking Brave Search as an Example)

docker run --rm -it -p 8080:8080 \
  -e BRAVE_API_KEY="your-api-key" \
  macmee/mcp-stdio-to-sse-wrapper

Other MCP Servers

# 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

📚 Documentation

Environment Variables

Kubernetes Example

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