mcp-proxy
starsforks
How to install mcp-proxy?
tbxark/mcp-proxy
$git clone https://github.com/tbxark/mcp-proxyAn MCP proxy that aggregates multiple MCP servers behind a single HTTP entrypoint.
README.md
| 1 | # MCP Proxy Server |
| 2 | |
| 3 | An MCP proxy that aggregates multiple MCP servers behind a single HTTP entrypoint. |
| 4 | |
| 5 | ## Features |
| 6 | |
| 7 | - Proxy multiple MCP clients: aggregate tools, prompts, and resources from many servers. |
| 8 | - SSE and streamable HTTP: serve via Server‑Sent Events or streamable HTTP. |
| 9 | - Flexible config: supports `stdio`, `sse`, and `streamable-http` client types. |
| 10 | - 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. |
| 11 | |
| 12 | ## Documentation |
| 13 | |
| 14 | - Configuration: [docs/configuration.md](docs/CONFIGURATION.md) |
| 15 | - Usage: [docs/usage.md](docs/USAGE.md) |
| 16 | - Deployment: [docs/deployment.md](docs/DEPLOYMENT.md) |
| 17 | - Claude config converter: https://tbxark.github.io/mcp-proxy |
| 18 | |
| 19 | ## Quick Start |
| 20 | |
| 21 | ### Build from source |
| 22 | |
| 23 | ```bash |
| 24 | git clone https://github.com/tbxark/mcp-proxy.git |
| 25 | cd mcp-proxy |
| 26 | make build |
| 27 | ./build/mcp-proxy --config path/to/config.json |
| 28 | ``` |
| 29 | |
| 30 | ### Install via Go |
| 31 | |
| 32 | ```bash |
| 33 | go install github.com/tbxark/mcp-proxy@latest |
| 34 | ``` |
| 35 | |
| 36 | ### Docker |
| 37 | |
| 38 | The image includes support for launching MCP servers via `npx` and `uvx`. |
| 39 | |
| 40 | ```bash |
| 41 | docker run -d -p 9090:9090 -v /path/to/config.json:/config/config.json ghcr.io/tbxark/mcp-proxy:latest |
| 42 | # or provide a remote config |
| 43 | docker run -d -p 9090:9090 ghcr.io/tbxark/mcp-proxy:latest --config https://example.com/config.json |
| 44 | ``` |
| 45 | |
| 46 | More deployment options (including docker‑compose) are in [docs/deployment.md](docs/DEPLOYMENT.md). |
| 47 | |
| 48 | ## Configuration |
| 49 | |
| 50 | See full configuration reference and examples in [docs/configuration.md](docs/CONFIGURATION.md). |
| 51 | An online Claude config converter is available at: https://tbxark.github.io/mcp-proxy |
| 52 | |
| 53 | |
| 54 | ## Usage |
| 55 | |
| 56 | Command‑line flags, endpoints, and auth examples are documented in [docs/usage.md](docs/USAGE.md). |
| 57 | |
| 58 | ## Thanks |
| 59 | |
| 60 | - This project was inspired by the [adamwattis/mcp-proxy-server](https://github.com/adamwattis/mcp-proxy-server) project |
| 61 | - If you have any questions about deployment, you can refer to [《在 Docker 沙箱中运行 MCP Server》](https://miantiao.me/posts/guide-to-running-mcp-server-in-a-sandbox/)([@ccbikai](https://github.com/ccbikai)) |
| 62 | |
| 63 | ## License |
| 64 | |
| 65 | This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. |
People who liked this also viewed
6 picksType
- mcp-proxy-for-awsAWS MCP Proxy ServerMCP ServersJul 2026
- pydantic-ai-backendFile Storage & Sandbox Backends for Pydantic AI: console tools for file operations, Docker-isolated sandboxes for safe execution, and permission system with presets for access control. Enables secure multi-user handling and testing in agents via in-memory, local, or containerized storage.MCP ServersJul 2026
- mcp-for-argocdAn implementation of Model Context Protocol (MCP) server for Argo CD.MCP ServersJul 2026
- heroku-mcp-serverHeroku Platform MCP Server using the Heroku CLIMCP ServersJul 2026
- ghost-mcpA Model Context Protocol (MCP) server for interacting with Ghost CMS through LLM interfaces like Claude. Allow you to control your Ghost blog by simply asking Claude etc.MCP ServersApr 2026
- Google DriveUpload, organize, and share files in the cloud. Manage folders, set permissions, and search across stored documents.MCP Serversrecently
