MCP Proxy Server

Name: MCP Proxy Server
Author: TBXark

@TBXark

Repository Homepage

About MCP Proxy Server

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

#mcp #claude #mcp-server #modelcontextprotocol #mcp-client

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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>"
    }
  }
}

Tools

Create or update a single file in a GitHub repository

Search for GitHub repositories

Create a new GitHub repository in your account

Get the contents of a file or directory from a GitHub repository

Push multiple files to a GitHub repository in a single commit

Create a new issue in a GitHub repository

Create a new pull request in a GitHub repository

Fork a GitHub repository to your account or specified organization

Create a new branch in a GitHub repository

Get list of commits of a branch in a GitHub repository

List issues in a GitHub repository with filtering options

Update an existing issue in a GitHub repository

Add a comment to an existing issue

Search for code across GitHub repositories

Search for issues and pull requests across GitHub repositories

Search for users on GitHub

Get details of a specific issue in a GitHub repository.

Get details of a specific pull request

List and filter repository pull requests

Create a review on a pull request

Merge a pull request

Get the list of files changed in a pull request

Get the combined status of all status checks for a pull request

Update a pull request branch with the latest changes from the base branch

Get the review comments on a pull request

Get the reviews on a pull request

Overview

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.