mcp-proxy

MCP Proxy Server

An MCP proxy that aggregates multiple MCP servers behind a single HTTP entrypoint.

Features

• Proxy multiple MCP clients: aggregate tools, prompts, and resources from many servers.
• SSE and streamable HTTP: serve via Server‑Sent Events or streamable HTTP.
• Flexible config: supports stdio, sse, and streamable-http client types.
• OAuth client support: authorize once against downstream servers that require interactive OAuth (e.g. Notion), then let the proxy hold and refresh the token for every caller.

Documentation

• Configuration: docs/configuration.md
• Usage: docs/usage.md
• Deployment: docs/deployment.md
• Claude config converter: https://tbxark.github.io/mcp-proxy

Quick Start

Build from source

git clone https://github.com/tbxark/mcp-proxy.git
cd mcp-proxy
make build
./build/mcp-proxy --config path/to/config.json

Install via Go

go install github.com/tbxark/mcp-proxy@latest

Docker

The image includes support for launching MCP servers via npx and uvx.

docker run -d -p 9090:9090 -v /path/to/config.json:/config/config.json ghcr.io/tbxark/mcp-proxy:latest
# or provide a remote config
docker run -d -p 9090:9090 ghcr.io/tbxark/mcp-proxy:latest --config https://example.com/config.json

More deployment options (including docker‑compose) are in docs/deployment.md.

Configuration

See full configuration reference and examples in docs/configuration.md. An online Claude config converter is available at: https://tbxark.github.io/mcp-proxy

Usage

Command‑line flags, endpoints, and auth examples are documented in docs/usage.md.

Thanks

• This project was inspired by the adamwattis/mcp-proxy-server project
• If you have any questions about deployment, you can refer to 《在 Docker 沙箱中运行 MCP Server》(@ccbikai)

License

This project is licensed under the MIT License. See the LICENSE file for details.