MCP Gateway

An MCP gateway that aggregates multiple MCP resource servers through a single interface.

Features

• MCP Proxy: A single endpoint for accessing multiple MCP servers
• Batch Request Tool: Optimized parallel execution for multiple tool calls
• Configuration Merging: Works with Claude desktop configuration

Configuration Paths

The gateway looks for configuration files in the following order:

1. Environment variable: MCP_CONFIG_PATH if set
2. Claude desktop config:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
3. Default: config.json in current directory

Config Merging with Claude

The gateway can read the proxyBatchMcpServers section from your Claude desktop config:

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "@thinkware/mcp-gateway"
      ]
    }
  },
  "proxyBatchMcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ],
      "toolOverrides": {
        "read_file": {
          "enabled": true,
          "description": "Read complete contents of a file\nInput: path (string)\nReads complete file contents with UTF-8 encoding"
        },
        "read_multiple_files": {
          "enabled": false
        }
      }
    },
    "server-1": {
      "command": "/path/to/server1/build/index.js",
      "toolOverrides": {
        "some_tool": {
          "enabled": true,
          "description": "Custom description"
        }
      }
    }
  }
}

Server Configuration Options

Option	Type	Description	Required
command	string	Path to server executable	Yes (for command servers)
args	string[]	Command arguments	No
env	object	Environment variables	No
url	string	SSE endpoint URL	Yes (for SSE servers)
toolOverrides	object	Tool customization	No

Tool Override Options

Option	Type	Description	Default
enabled	boolean	Enable/disable tool	true
description	string	Custom tool description	Original description
disabled	boolean	Disable entire tool	false

Environment Variables

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "@thinkware/mcp-gateway"
      ],
      "env": {
        "MCP_GATEWAY_LOG_FILE": "/path/to/logs/mcp-gateway.log"
      }
    }
  }
}

Development

# Install dependencies
npm install

# Development with auto-rebuild
npm run dev

# Build
npm run build