Skip to content
Back to search

mcp-proxy

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tbxark--mcp-proxy/badge.svg)](/listings/tbxark--mcp-proxy)

HTML

<a href="/listings/tbxark--mcp-proxy"><img src="/api/listings/tbxark--mcp-proxy/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](docs/DEPLOYMENT.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 65 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Proxy Server
  2. An MCP proxy that aggregates multiple MCP servers behind a single HTTP entrypoint.
  3. ## Features
  4. - Proxy multiple MCP clients: aggregate tools, prompts, and resources from many servers.
  5. - SSE and streamable HTTP: serve via Server‑Sent Events or streamable HTTP.
  6. - Flexible config: supports `stdio`, `sse`, and `streamable-http` client types.
  7. - 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.
  8. ## Documentation
  9. - Configuration: [docs/configuration.md](docs/CONFIGURATION.md)
  10. - Usage: [docs/usage.md](docs/USAGE.md)
  11. - Deployment: [docs/deployment.md](docs/DEPLOYMENT.md)
  12. - Claude config converter: https://tbxark.github.io/mcp-proxy
  13. ## Quick Start
  14. ### Build from source
  15. ```bash
  16. git clone https://github.com/tbxark/mcp-proxy.git
  17. cd mcp-proxy
  18. make build
  19. ./build/mcp-proxy --config path/to/config.json
  20. ```
  21. ### Install via Go
  22. ```bash
  23. go install github.com/tbxark/mcp-proxy@latest
  24. ```
  25. ### Docker
  26. The image includes support for launching MCP servers via `npx` and `uvx`.
  27. ```bash
  28. docker run -d -p 9090:9090 -v /path/to/config.json:/config/config.json ghcr.io/tbxark/mcp-proxy:latest
  29. # or provide a remote config
  30. docker run -d -p 9090:9090 ghcr.io/tbxark/mcp-proxy:latest --config https://example.com/config.json
  31. ```
  32. More deployment options (including docker‑compose) are in [docs/deployment.md](docs/DEPLOYMENT.md).
  33. ## Configuration
  34. See full configuration reference and examples in [docs/configuration.md](docs/CONFIGURATION.md).
  35. An online Claude config converter is available at: https://tbxark.github.io/mcp-proxy
  36. ## Usage
  37. Command‑line flags, endpoints, and auth examples are documented in [docs/usage.md](docs/USAGE.md).
  38. ## Thanks
  39. - This project was inspired by the [adamwattis/mcp-proxy-server](https://github.com/adamwattis/mcp-proxy-server) project
  40. - 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))
  41. ## License
  42. This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.