Aggregate Multiple MCP Servers
Aggregates multiple MCP servers behind a single HTTP entrypoint, serving via SSE or streamable HTTP.
Maintainer of this project? Claim this page to edit the listing.
0.43.2Add to Favorites
Why it matters
Unify access to multiple MCP servers, consolidating tools, prompts, and resources into a single, streamlined HTTP interface for enhanced productivity.
Outcomes
What it gets done
Proxy multiple MCP clients simultaneously.
Aggregate diverse tools, prompts, and resources.
Serve aggregated content via SSE or streaming HTTP.
Configure flexible client types (stdio, sse, streamable-http).
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-mcp-proxy-server | bash Overview
MCP Proxy Server
MCP Proxy Server aggregates tools, prompts, and resources from multiple stdio/sse/streamable-http MCP servers behind a single HTTP entrypoint. Use it when running multiple MCP servers that need to be exposed through one consolidated HTTP endpoint; it is a proxy layer, not an MCP server itself.
What it does
MCP Proxy Server aggregates tools, prompts, and resources from multiple MCP servers behind a single HTTP entrypoint. It can proxy MCP clients configured as stdio, sse, or streamable-http, and serves the combined result via Server-Sent Events or streamable HTTP.
When to use - and when NOT to
Use this when you run several separate MCP servers and want a single HTTP endpoint that exposes all their tools/prompts/resources combined, rather than configuring each client to connect to every server individually. It is a proxy/aggregation layer, not an MCP server implementation itself - it depends on the underlying MCP servers it's configured to front.
Capabilities
Aggregates any mix of stdio, sse, and streamable-http MCP servers into one HTTP entrypoint, and includes an online Claude config converter (https://tbxark.github.io/mcp-proxy) to help generate compatible configuration.
How to install
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
Or install via Go (go install github.com/tbxark/mcp-proxy@latest), or run the Docker image (which 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
Who it's for
Developers running multiple MCP servers who want to consolidate them behind one HTTP endpoint for a client, instead of managing separate connections to each server.
Source README
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, andstreamable-httpclient types.
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)
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.