MCP serverSafeAgent workflow & memoryAdvanced

mcp-proxy

An MCP proxy server that aggregates and serves multiple MCP resource servers through a single HTTP entrypoint, supporting various client types and OAuth.

An MCP proxy server that aggregates and serves multiple MCP resource servers through a single HTTP server.

734 stars108License: MITUpdated last month0 opens

Preview

▍

What you can do with it

Aggregate tools, prompts, and resources from various MCP servers into a single endpoint for agents.
Manage OAuth authorizations for downstream servers, allowing the proxy to handle token refresh.
Simplify agent configuration by providing one local endpoint instead of configuring multiple MCP servers directly.

Safety check

Safe

No risky patterns found in the files we scanned.

Automated scan of the repo files. Always review code you run.

From the 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, 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.

View source on GitHub