MCP Proxy
Enables dynamic loading, hot-reloading, and orchestration of MCP servers without restarting Claude Code, allowing programmatic tool calling and workflow automation across multiple servers.
What is MCP Proxy?
MCP Proxy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables dynamic loading, hot-reloading, and orchestration of mcp servers without restarting claude code, allowing programmatic tool calling and workflow automation across multiple servers.
Enables dynamic loading, hot-reloading, and orchestration of MCP servers without restarting Claude Code, allowing programmatic tool calling and workflow automation across multiple servers.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables dynamic loading, hot-reloading, and orchestration of
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @jetbrains/mcp-proxyManual Installation
npx -y @jetbrains/mcp-proxyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Proxy
MCP Proxy is a meta-MCP server that enables dynamic loading, hot-reloading, and orchestration of other MCP servers at runtime — without restarting Claude Code or your MCP client. It exposes 13 tools covering the full server lifecycle: loading servers from git or npm, listing and unloading them, reloading after code changes, searching across all tool definitions, and calling tools on dynamically loaded servers. Teams working with multiple MCP servers or developing custom servers can use it to iterate rapidly and chain tool calls across servers in complex automation workflows.
Prerequisites
- Python 3.9 or later with pip
- Git installed on the system (for installing servers from git repositories)
- Claude Code or another MCP-compatible client
- The mcp_proxy repository cloned locally
Clone the mcp_proxy repository
Clone the repository to a permanent location on your machine. The path to this directory will be needed in the configuration.
git clone https://github.com/lizTheDeveloper/mcp_proxy.git
cd mcp_proxyInstall Python dependencies
Install the required Python packages from the requirements file.
pip install -r requirements.txtAdd MCP Proxy to Claude Code
Register the proxy server with Claude Code using the 'claude mcp add' command. This is the recommended approach for Claude Code users.
claude mcp add mcp-proxy -- python -m mcp_proxy.servers.proxy_serverConfigure via claude_desktop_config.json (alternative)
For Claude Desktop or other MCP clients, add the server manually to the config file. PYTHONPATH must point to the parent directory of the mcp_proxy folder.
{
"mcpServers": {
"mcp-proxy": {
"command": "python",
"args": ["-m", "mcp_proxy.servers.proxy_server"],
"cwd": "/path/to/mcp_proxy",
"env": {
"PYTHONPATH": "/path/to"
}
}
}
}Load and call a server dynamically
Once connected, use the load_mcp_server_dynamically tool to load another MCP server at runtime, then call its tools with call_dynamic_server_tool — no client restart required.
MCP Proxy Examples
Client configuration
claude_desktop_config.json entry for MCP Proxy. Replace /path/to/mcp_proxy with the actual clone location.
{
"mcpServers": {
"mcp-proxy": {
"command": "python",
"args": ["-m", "mcp_proxy.servers.proxy_server"],
"cwd": "/path/to/mcp_proxy",
"env": {
"PYTHONPATH": "/path/to"
}
}
}
}Prompts to try
Example prompts that use MCP Proxy's dynamic loading and cross-server orchestration capabilities.
- "Load the filesystem MCP server from its npm package and list the tools it provides."
- "Install the mcp-git server from its GitHub repo, load it, and clone a repository."
- "Show me all currently loaded MCP servers and their available tools."
- "Reload the custom server I'm developing so it picks up my latest code changes."
- "Search across all loaded servers for any tool that can send HTTP requests."Troubleshooting MCP Proxy
ModuleNotFoundError: No module named 'mcp_proxy'
The PYTHONPATH environment variable must point to the parent directory of the mcp_proxy folder (not the mcp_proxy folder itself). If cloned to /home/user/mcp_proxy, set PYTHONPATH to /home/user.
Dynamically loaded server tools are not callable
Use call_dynamic_server_tool with the exact server ID returned by load_mcp_server_dynamically. If the server failed to load (connection error, missing deps), check with get_loaded_servers to see its status.
Hot-reload does not pick up code changes
Use the reload_mcp_server tool with the server's ID to trigger an explicit reload. Python module caching can prevent automatic detection of file changes — always use the reload tool after editing server code.
Frequently Asked Questions about MCP Proxy
What is MCP Proxy?
MCP Proxy is a Model Context Protocol (MCP) server that enables dynamic loading, hot-reloading, and orchestration of mcp servers without restarting claude code, allowing programmatic tool calling and workflow automation across multiple servers. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Proxy?
Install via npm with the command: npx -y @jetbrains/mcp-proxy. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with MCP Proxy?
MCP Proxy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Proxy free to use?
Yes, MCP Proxy is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Proxy Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCP Proxy? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Proxy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Proxy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.