Sandbox
@tbxark/mcp-proxy

MCP proxy server for one HTTP entrypoint

MCP Proxy Server aggregates tools, prompts, and resources from multiple MCP servers and serves them through a single HTTP endpoint. It supports stdio, SSE, and streamable HTTP clients, so you can point one proxy at mixed downstream servers.

719 stars107 forksGoUpdated 1mo ago
Who it's for

Builders who want to connect Claude Code or other MCP clients to several servers through one proxy.

What it delivers

You can manage multiple MCP services through one endpoint instead of configuring each server separately.

What it does

Aggregates multiple MCP servers

Combines tools, prompts, and resources from many downstream servers into one proxy.

Supports multiple transport types

Works with `stdio`, `sse`, and `streamable-http` client types.

Serves over HTTP

Exposes the proxy through SSE or streamable HTTP.

Handles OAuth for downstream servers

Authorizes once against servers like Notion, then stores and refreshes the token for later calls.

Includes deployment examples

Provides Docker and docker-compose setup, plus deployment docs.

How to get it

  1. 1Run
    git clone https://github.com/tbxark/mcp-proxy.git
    cd mcp-proxy
    make build
    ./build/mcp-proxy --config path/to/config.json
  2. 2Run
    go install github.com/tbxark/mcp-proxy@latest
  3. 3The 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

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

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

License

This project is licensed under the MIT License. See the LICENSE file for details.

Files in the repo

Repository payload29 top-level entries
  • .github
  • docs
  • test
  • testdata
  • .dockerignore
  • .gitattributes
  • .gitignore
  • .goreleaser.yaml
  • client_test.go
  • client.go
  • config_test.go
  • config.go
  • config.json
  • docker-compose.yaml
  • Dockerfile
  • doctor_test.go
  • doctor.go
  • go.mod
  • go.sum
  • http_test.go
  • http.go
  • LICENSE
  • main.go
  • Makefile
  • oauth_store_test.go
  • oauth_store.go
  • oauth_test.go
  • oauth.go
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k
t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k