MCP Proxy Server

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

Features

• Proxy Multiple MCP Clients: Connects to multiple MCP resource servers and aggregates their tools and capabilities.
• SSE / HTTP Streaming MCP Support: Provides an SSE (Server-Sent Events) or HTTP streaming interface for real-time updates from MCP clients.
• Flexible Configuration: Supports multiple client types (stdio, sse or streamable-http) with customizable settings.

Installation# 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 by go

go install github.com/TBXark/mcp-proxy@latest\n\n# Or install stable version
go install github.com/TBXark/mcp-proxy

Docker

The Docker image supports two MCP calling methods by default: npx and uvx.

docker run -d -p 9090:9090 -v /path/to/config.json:/config/config.json ghcr.io/tbxark/mcp-proxy:latest\n\n# or
docker run -d -p 9090:9090 ghcr.io/tbxark/mcp-proxy:latest --config https://example.com/path/to/config.json

Configuration

The server is configured using a JSON file. Below is an example configuration:

{
  "mcpProxy": {
    "baseURL": "https://mcp.example.com",
    "addr": ":9090",
    "name": "MCP Proxy",
    "version": "1.0.0",
    "type": "streamable-http",
    "options": {
      "panicIfInvalid": false,
      "logEnabled": true,
      "authTokens": ["DefaultTokens"]
    }
  },
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": ""},
      "options": {
        "toolFilter": {
          "mode": "block",
          "list": ["create_or_update_file"]
        }
      }
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "options": {
        "panicIfInvalid": true,
        "logEnabled": false,
        "authTokens": ["SpecificTokens"]
      }
    },
    "amap": {
      "url": "https://mcp.amap.com/sse?key="
    }
  }
}

License

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