mcp-gateway

# 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: ```json { "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 ```json { "mcpServers": { "mcp-gateway": { "command": "npx", "args": [ "-y", "@thinkware/mcp-gateway" ], "env": { "MCP_GATEWAY_LOG_FILE": "/path/to/logs/mcp-gateway.log" } } } } ``` ## Development ```bash # Install dependencies npm install # Development with auto-rebuild npm run dev # Build npm run build ```