MCP Proxy Server

What is MCP Proxy Server?

MCP Proxy Server is a central hub that aggregates and serves multiple MCP resource servers through a single unified interface. It connects to, manages, and routes requests to backend MCP servers, combining their capabilities for clients.

How to use MCP Proxy Server?

Install dependencies with npm install, build with npm run build, then run with MCP_CONFIG_PATH=./config.json mcp-proxy-server. Provide a JSON configuration file (copy config.example.json) listing the MCP servers to connect. For Claude Desktop, add the server config to claude_desktop_config.json.

Key features of MCP Proxy Server

• Discover and connect to multiple MCP resource servers
• Aggregate resources from all connected servers
• Route tool calls to appropriate backend servers
• Aggregate prompts from all connected servers
• Handle multi-server prompt responses
• Maintain consistent URI schemes across servers

Use cases of MCP Proxy Server

• Centralize access to multiple MCP resource servers behind one endpoint
• Combine tools from different MCP servers into a single interface
• Simplify client integration by reducing the number of server connections
• Route prompt requests to the correct backend automatically

FAQ from MCP Proxy Server

How do I configure the server?

Copy config.example.json to config.json and modify it with the list of MCP servers (including transport commands and arguments). Then set the MCP_CONFIG_PATH environment variable to the path of your config file when running the server.

How do I install and build the server?

Run npm install to install dependencies, then npm run build to compile the TypeScript source. For development with auto-rebuild, use npm run watch.

How can I debug the server?

Use the MCP Inspector by running npm run inspector. It provides a URL to access debugging tools in your browser.

How do I use it with Claude Desktop?

Add an entry to the Claude Desktop config file (claude_desktop_config.json) with the command pointing to the built index.js and the MCP_CONFIG_PATH environment variable set to the absolute path of your config file.

What transport does it use?

The server communicates over stdio, as configured via the command and optional args in the server transport configuration.