Lazy MCP Proxy
MCP proxy server with lazy loading support - reduces context usage through on-demand tool activation
What is Lazy MCP Proxy?
Lazy MCP Proxy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp proxy server with lazy loading support - reduces context usage through on-demand tool activation
MCP proxy server with lazy loading support - reduces context usage through on-demand tool activation
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP proxy server with lazy loading support - reduces context
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx lazyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Lazy MCP Proxy
Lazy MCP is a Go-based proxy server that wraps existing MCP servers and exposes their tools through a hierarchical lazy-loading mechanism, dramatically reducing the number of tools visible in an AI assistant's context at any given time. Instead of loading all tools upfront, it presents two meta-tools — get_tools_in_category and execute_tool — that let the AI navigate a category tree and activate tools on demand. Developers working in context-constrained environments use it to proxy dozens of MCP servers without overwhelming the model's context window with hundreds of tool definitions.
Prerequisites
- Go 1.21+ installed for building from source (or a pre-built binary)
- Make build tool installed on your system
- Existing MCP servers you want to proxy, with their configuration details
- An MCP-compatible client such as Claude Desktop, Cursor, or VS Code
Clone and build Lazy MCP
Clone the repository and build both the MCP proxy binary and the structure generator tool using Make.
git clone https://github.com/voicetreelab/lazy-mcp.git
cd lazy-mcp
make buildCreate your config.json
Create a config.json file that lists the MCP servers you want to proxy. Each server entry includes its command, arguments, and environment variables.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_yourtoken"}
}
}
}Generate the tool hierarchy structure
Run the structure generator to analyze your configured MCP servers and produce a hierarchy file that defines how tools are grouped into categories.
./build/structure_generator --config config.json --output testdata/mcp_hierarchyConfigure your MCP client to use the proxy
Register the Lazy MCP proxy as your MCP server. It will intercept requests and expose the hierarchical navigation tools instead of all underlying server tools at once.
{
"mcpServers": {
"lazy-mcp": {
"command": "/path/to/lazy-mcp/build/mcp-proxy",
"args": ["--config", "/path/to/lazy-mcp/config.json"]
}
}
}Configure sensitive tool controls (optional)
Set environment variables to control which tools require permission prompts and which are completely blocked for safety.
export LAZY_MCP_SENSITIVE_TOOLS="write_file,delete_file,execute_command"
export LAZY_MCP_DENIED_TOOLS="rm,format_disk"Lazy MCP Proxy Examples
Client configuration
Add Lazy MCP proxy to Claude Desktop, pointing to your compiled binary and config file.
{
"mcpServers": {
"lazy-mcp": {
"command": "/home/user/lazy-mcp/build/mcp-proxy",
"args": ["--config", "/home/user/lazy-mcp/config.json"],
"env": {
"LAZY_MCP_SENSITIVE_TOOLS": "write_file,delete_file"
}
}
}
}Prompts to try
Interact with the hierarchical tool system through natural navigation.
- "What tool categories are available?"
- "Show me the tools under the filesystem category"
- "Use the github tools to list open pull requests in my repository"
- "Navigate to the database tools and query the users table"
- "Which tools are available for file operations?"Troubleshooting Lazy MCP Proxy
make build fails with Go version errors
Ensure Go 1.21 or later is installed. Run 'go version' to check. Download the latest Go from golang.org/dl if needed, and ensure the go binary is in your PATH.
Proxied MCP server tools are not appearing in categories
Re-run the structure_generator after any changes to config.json. The hierarchy file must be regenerated whenever you add or remove servers from your configuration.
execute_tool fails with 'server not initialized'
Lazy MCP initializes proxied servers on demand when their tools are first requested. If initialization fails, check that the proxied server's command and args in config.json are correct and that any required environment variables are present.
Frequently Asked Questions about Lazy MCP Proxy
What is Lazy MCP Proxy?
Lazy MCP Proxy is a Model Context Protocol (MCP) server that mcp proxy server with lazy loading support - reduces context usage through on-demand tool activation It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Lazy MCP Proxy?
Follow the installation instructions on the Lazy MCP Proxy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Lazy MCP Proxy?
Lazy MCP Proxy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Lazy MCP Proxy free to use?
Yes, Lazy MCP Proxy is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Lazy MCP Proxy Alternatives — Similar Developer Tools Servers
Looking for alternatives to Lazy 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 Lazy 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 Lazy 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.