MCP Proxy Server

Name: MCP Proxy Server
Author: TBXark

@TBXark

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

その他 #mcp #claude #mcp-server #modelcontextprotocol #mcp-client

リポジトリホームページ

What is MCP Proxy Server?

MCP Proxy Server is an MCP proxy that aggregates multiple MCP servers behind a single HTTP entrypoint. It is designed for developers who need to consolidate tools, prompts, and resources from many MCP servers into one unified endpoint.

How to use MCP Proxy Server?

Build from source, install via Go, or use the Docker image. Run the binary with a JSON configuration file using the --config flag. Detailed configuration and usage are documented in the linked docs.

Key features of MCP Proxy Server

Aggregates multiple MCP servers into one HTTP endpoint.
Supports SSE and streamable HTTP server transports.
Supports stdio, SSE, and streamable-http client types.
Configurable via a JSON configuration file.
Docker image includes npx and uvx support.
Online Claude config converter available.

Use cases of MCP Proxy Server

Consolidate several specialized MCP servers behind a single entrypoint for a client application.
Expose local MCP servers over a network using SSE.
Deploy MCP servers in Docker containers with a unified proxy.
Convert an existing Claude configuration to proxy format via the online tool.
Use as a gateway to stream resources from multiple servers to a single client.

FAQ from MCP Proxy Server

How do I configure the proxy?

Use a JSON configuration file; see the full reference in docs/configuration.md.

What transport protocols does the proxy support for clients?

It supports stdio, SSE, and streamable-http client types.

Can I run it in Docker?

Yes, the Docker image supports launching MCP servers via npx and uvx. See docs/deployment.md for details.

Is there an example Claude configuration converter?

Yes, an online converter is available at https://tbxark.github.io/mcp-proxy.

How do I deploy the proxy?

Refer to docs/deployment.md for Docker, docker-compose, and other deployment options.

サーバー設定

{
  "mcpProxy": {
    "baseURL": "https://mcp.example.com",
    "addr": ":9090",
    "name": "MCP Proxy",
    "version": "1.0.0",
    "options": {
      "panicIfInvalid": false,
      "logEnabled": true,
      "authTokens": [
        "DefaultTokens"
      ]
    }
  },
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_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=<YOUR_TOKEN>"
    }
  }
}