MCP SSE Proxy Server

Name: MCP SSE Proxy Server
Author: jinyalong

@jinyalong

代码仓库

关于 MCP SSE Proxy Server

Start any MCP Server remotely using the MCP standard protocol.

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

jinyalong

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcpproxy": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP SSE Proxy Server?

The MCP SSE Proxy Server is a Server-Sent Events (SSE) based Model Context Protocol (MCP) proxy server that enables remote execution of MCP servers using the standard MCP protocol. It supports both shared and independent session modes.

How to use MCP SSE Proxy Server?

Configure via environment variables (AUTH_KEY, SHARED_SESSION, MCP_SERVER_CONFIG) and run the server using Python (python main.py) or Docker (docker run codefriday123/mcpproxy:1.0). Connect clients to the GET /sse endpoint and send JSON-RPC messages to the returned message endpoint via POST /messages.

Key features of MCP SSE Proxy Server

SSE long connection support for server push
JSON-RPC 2.0 message format support
Both shared and independent session modes
Dynamic session environment configuration via request parameters
Automatic connection keep-alive (30-second heartbeat)
Built-in support for NPX and UVX STDIO process deployment

Use cases of MCP SSE Proxy Server

Deploy a single proxy server serving multiple users with individual GitHub credentials
Integrate with Chrome/Chromium for browser-based MCP servers
Bundle with databases for data manipulation MCP servers
Package with development tools for code-related MCP servers
Create specialized MCP server clusters with custom routing

FAQ from MCP SSE Proxy Server

What session modes are available?

The server supports two modes controlled by SHARED_SESSION: shared mode (default, all clients share one MCP session) and independent mode (each client creates a separate MCP session).

How do I secure the server?

Set the AUTH_KEY environment variable; all requests must then provide this key as a URL parameter auth_key.

How can I dynamically configure environment per session?

In independent session mode, pass custom environment variables as URL query parameters on the SSE connection (e.g., GET /sse?auth_key=xxx&GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxx).

How do I run the server with Docker?

Pull the image codefriday123/mcpproxy:1.0 and run with -p 8000:8000, setting AUTH_KEY, SHARED_SESSION, and MCP_SERVER_CONFIG environment variables.