MCPProxy Go
๐๏ธ ๐ ๐ ๐ช ๐ง - Local MCP proxy with BM25 tool filtering, quarantine securit
What is MCPProxy Go?
MCPProxy Go is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐๏ธ ๐ ๐ ๐ช ๐ง - local mcp proxy with bm25 tool filtering, quarantine securit
๐๏ธ ๐ ๐ ๐ช ๐ง - Local MCP proxy with BM25 tool filtering, quarantine securit
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcpproxy-goConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCPProxy Go
MCPProxy Go is a local MCP aggregator and smart proxy that consolidates multiple MCP servers behind a single endpoint, applying BM25-based tool filtering to dramatically reduce context window token usage when many tools are registered. It adds security quarantine for new servers, detailed audit logging, and an embedded web dashboard for managing connections and reviewing activity. Teams running dozens of MCP tools across Cursor, Claude Desktop, or custom clients can bypass tool-count limits (Cursor's 40-tool cap, OpenAI's 128-function cap) and cut token overhead by up to 99% with ranked tool selection.
Prerequisites
- Go 1.21+ (if building from source) or use a pre-built binary/installer
- macOS, Linux, or Windows operating system
- One or more existing MCP servers you want to aggregate
- An MCP-compatible client such as Claude Desktop or Cursor
Install MCPProxy
Install MCPProxy using the package manager for your OS. Homebrew is recommended on macOS; apt is available for Debian/Ubuntu; a .exe installer is provided for Windows.
# macOS (CLI only):
brew install smart-mcp-proxy/mcpproxy/mcpproxy
# macOS (GUI + menu-bar app):
brew install --cask smart-mcp-proxy/mcpproxy/mcpproxy
# Go install:
go install github.com/smart-mcp-proxy/mcpproxy-go/cmd/mcpproxy@latestCreate the proxy configuration file
Create ~/.mcpproxy/mcp_config.json listing all the MCP servers you want to aggregate. Each entry can be a local stdio process or a remote HTTP server.
{
"listen": "127.0.0.1:8080",
"mcpServers": [
{
"name": "filesystem",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
"protocol": "stdio",
"enabled": true
},
{
"name": "remote-server",
"url": "http://localhost:3001",
"protocol": "http",
"enabled": true
}
]
}Start the MCPProxy server
Launch the proxy. It starts an HTTP listener on port 8080 by default and begins aggregating all configured MCP servers.
mcpproxy serveConnect your MCP client to the proxy
Point Claude Desktop or Cursor at the proxy's single endpoint instead of individual servers. For Claude Desktop, use mcp-remote as a bridge.
{
"mcpServers": {
"mcpproxy": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8080/mcp"]
}
}
}Open the web dashboard
Navigate to http://localhost:8080 in your browser to view the embedded dashboard, manage server connections, review audit logs, and monitor tool usage.
MCPProxy Go Examples
Client configuration
Claude Desktop configuration that connects to MCPProxy via mcp-remote, exposing all aggregated servers through a single proxy endpoint.
{
"mcpServers": {
"mcpproxy": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8080/mcp"]
}
}
}Prompts to try
Example prompts that benefit from MCPProxy's tool aggregation and BM25 ranking across many registered servers.
- "Search the filesystem for all TypeScript files modified in the last 7 days."
- "Run a Snyk security scan on the current project and summarize vulnerabilities."
- "Show me the audit log of MCP tool calls made in this session."
- "List all tools available across my registered MCP servers."
- "Which tools are most relevant for querying a Postgres database?"Troubleshooting MCPProxy Go
New MCP servers are blocked and not responding to tool calls
MCPProxy applies automatic security quarantine to newly added servers. Open the web dashboard at http://localhost:8080, find the quarantined server, and approve it before it will handle requests.
Claude Desktop cannot connect to the proxy endpoint
Ensure mcpproxy serve is running before starting Claude Desktop. The proxy must be listening on 127.0.0.1:8080. If you changed the port in mcp_config.json, update the mcp-remote URL in claude_desktop_config.json to match.
BM25 filtering is excluding tools that should be available
BM25 ranking scores tools by relevance to the current query, so less-relevant tools may be filtered from the context window. Rephrase your prompt to include keywords that match the tool's description, or increase the tool limit in the proxy configuration.
Frequently Asked Questions about MCPProxy Go
What is MCPProxy Go?
MCPProxy Go is a Model Context Protocol (MCP) server that ๐๏ธ ๐ ๐ ๐ช ๐ง - local mcp proxy with bm25 tool filtering, quarantine securit It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCPProxy Go?
Follow the installation instructions on the MCPProxy Go GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCPProxy Go?
MCPProxy Go works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCPProxy Go free to use?
Yes, MCPProxy Go is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCPProxy Go Alternatives โ Similar Developer Tools Servers
Looking for alternatives to MCPProxy Go? 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 MCPProxy Go 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 MCPProxy Go?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.