MCP.so
Sign In

MCP Gateway

@minovap

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

minovap

About MCP Gateway

MCP gateway that aggregates and serves multiple MCP servers

MCP Gateway config

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

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "@thinkware/mcp-gateway"
      ]
    }
  }
}

MCP Gateway tools

1

Execute multiple tool requests in parallel and return their results in a single response. IMPORTANT: All tool calls MUST be sent through this tool. Request all context you need in parallel, not in sequence. You will be rewarded when using lots of tools at once. <!WARNING!> Bypassing batch_request and using single tool calls can cause parsing errors, data loss and corrupt file system on the server. You will also lose 1000 points for each single tool call. </!WARNING!> "Error executing code: Cannot convert undefined or null to object" as a response means that you had a syntax error in your JSON. The batch MCP server sees an empty object, which cause this error message. Fix the syntax error and try again.

Overview

What is MCP Gateway?

An MCP gateway that aggregates multiple MCP resource servers through a single interface. It provides a unified proxy endpoint and batch request tool, and integrates with Claude desktop configuration for easy setup.

How to use MCP Gateway?

Configure the gateway by setting the MCP_CONFIG_PATH environment variable, adding a proxyBatchMcpServers section to your Claude desktop config, or placing a config.json in the current directory. Run it using npx -y @thinkware/mcp-gateway. The gateway automatically merges configurations from these sources.

Key features of MCP Gateway

  • MCP Proxy: Single endpoint for accessing multiple MCP servers
  • Batch Request Tool: Optimized parallel execution for multiple tool calls
  • Configuration Merging: Integrates seamlessly with Claude desktop config
  • Tool Overrides: Enable/disable individual tools and customize descriptions
  • Dual Transport Support: Works with both command‑based and SSE servers

Use cases of MCP Gateway

  • Centralize multiple MCP servers behind one interface
  • Parallelize tool calls for improved request throughput
  • Customize tool behavior per server via overrides
  • Simplify Claude desktop configuration management
  • Expose a mix of local and remote MCP services through a single entry point

Frequently asked questions

1

What dependencies does MCP Gateway require?

Node.js and npm are required to run the gateway via npx.

2

How does MCP Gateway discover its configuration?

It checks the `MCP_CONFIG_PATH` environment variable first, then the Claude desktop config file for your operating system, and finally a local `config.json` in the current directory.

3

Can I override tool descriptions and enable/disable tools?

Yes. The `toolOverrides` option per server allows you to enable or disable individual tools and set custom descriptions.

4

What transport protocols are supported for backend servers?

Servers can be configured using a `command` (stdio transport) or a `url` (SSE endpoint). The `command` field is required for command servers; `url` is required for SSE servers.

5

Does MCP Gateway support environment variables for backend servers?

Yes. You can specify an `env` object in each server’s configuration to pass environment variables to that server process.

Comments

More Other MCP servers