mcp-proxy

KO | EN

gitlite — search

#typescript #llm #android #machine-learning #rust #linux #docker #macos #nodejs #cli #kubernetes #pytorch #openai #open-source

(★ 717)

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

파일 탐색기

최종 버전 다운로드 (.zip)

- - docker.yml
  - goreleaser.yml
- CONFIGURATION.md
- DEPLOYMENT.md
- index.html
- USAGE.md
- - cli_test.go
  - doc.go
  - helpers_test.go
  - remote_test.go
  - stdio_test.go
- - main.go
.dockerignore
.gitattributes
.gitignore
.goreleaser.yaml
client.go
client_test.go
config.go
config.json
config_test.go
docker-compose.yaml
Dockerfile
doctor.go
doctor_test.go
go.mod
go.sum
http.go
http_test.go
LICENSE
main.go
Makefile
oauth.go
oauth_store.go
oauth_store_test.go
oauth_test.go
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](docs/CONFIGURATION.md)
- Usage: [docs/usage.md](docs/USAGE.md)
- Deployment: [docs/deployment.md](docs/DEPLOYMENT.md)
- Claude config converter: https://tbxark.github.io/mcp-proxy

## Quick Start

### Build from source

```bash
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

```bash
go install github.com/tbxark/mcp-proxy@latest
```

### Docker

The image includes support for launching MCP servers via `npx` and `uvx`.

```bash
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).

## Configuration

See full configuration reference and examples in [docs/configuration.md](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](docs/USAGE.md).

## Thanks

- This project was inspired by the [adamwattis/mcp-proxy-server](https://github.com/adamwattis/mcp-proxy-server) project
- 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))

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

mcp-proxy

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

mcp-proxy

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README