Overview
What is mcp-proxy-server?
mcp-proxy-server is a proxy server for the Model Context Protocol (MCP) that enables connections to multiple backend MCP servers. It is intended for developers who need to aggregate or route MCP requests to different server instances.
How to use mcp-proxy-server?
Install globally via npm install -g @pyleeai/mcp-proxy-server or as a library in a project with npm install @pyleeai/mcp-proxy-server. Run the server with the command mcp-proxy-server and configure it by setting the CONFIGURATION_URL environment variable (required) to a JSON file defining the backend MCP servers; LOG_PATH is optional for logging.
Key features of mcp-proxy-server
- Acts as a proxy for multiple backend MCP servers
- Configurable via a remote JSON configuration file
- Optional logging to a specified file path
- Can be installed globally or used as a library
- Built with Bun and designed for extensibility
Use cases of mcp-proxy-server
- Route MCP requests to different backend servers based on configuration
- Aggregate multiple MCP servers behind a single endpoint
- Centralize MCP server management and logging
FAQ from mcp-proxy-server
What exactly does mcp-proxy-server do?
It proxies MCP protocol requests to one or more backend MCP servers defined in a configuration JSON, allowing a single endpoint to serve multiple backends.
What are the runtime requirements for mcp-proxy-server?
For production use, the README shows installation via npm, implying Node.js is required. Development requires Bun v1.2.2 or later.
How is mcp-proxy-server configured?
You must set the CONFIGURATION_URL environment variable to point to a JSON file that lists the backend MCP servers (e.g., with command and args). An optional LOG_PATH environment variable sets the log file location.
Does mcp-proxy-server support authentication or encryption?
The README does not mention authentication, encryption, or transport security.
Where does mcp-proxy-server store data?
No data storage is described; it appears to be a stateless proxy that only forwards requests and logs.
