About MCP Proxy Server
MCP Proxy Server is an MCP server published by tbxark in the Developer Tools category: an MCP proxy server that aggregates and serves multiple MCP resource servers through a single HTTP server.
The repository has 738 stars and 111 forks, with the last commit 8 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add proxy -- npx -y @aauth/proxynpx -y @aauth/proxyThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about MCP Proxy Server
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 10 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
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. - 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.
README fetched from the repository 10 hours ago. The original is authoritative.