tbxark/mcp-proxy

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
Install via Go
Docker
The image includes support for launching MCP servers via npx and uvx.
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.