Add it to Claude Code
claude mcp add mcpproxy-go -- mcpproxy serveMake your agent remember this setup
mcpproxy-go's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Federates hundreds of MCP servers into a single endpoint
- Bypasses Cursor's 40-tool limit and OpenAI's 128-function cap
- Automatic security quarantine for new MCP servers
- Intelligent tool discovery with BM25
- Native cross-platform support with system-tray UI
Tools 1
retrieve_toolsRetrieves and federates tools from multiple upstream MCP servers to bypass API limits.Try it
Original README from smart-mcp-proxy/mcpproxy-go
MCPProxy – Smart Proxy for AI Agents
MCPProxy is an open-source desktop application that super-charges AI agents with intelligent tool discovery, massive token savings, and built-in security quarantine against malicious MCP servers.
**📚 [Read the Documentation](https://docs.mcpproxy.app/)**
🌐 Visit mcpproxy.app
<a href="https://mcpproxy.app/images/menu_upstream_servers.png" target="_blank"> </a> <a href="https://mcpproxy.app/images/menu_security_quarantine.png" target="_blank"> </a><em>System Tray - Upstream Servers System Tray - Quarantine Management</em>
Why MCPProxy?
- Scale beyond API limits – Federate hundreds of MCP servers while bypassing Cursor's 40-tool limit and OpenAI's 128-function cap.
- Save tokens & accelerate responses – Agents load just one
retrieve_toolsfunction instead of hundreds of schemas. Research shows ~99 % token reduction with 43 % accuracy improvement. - Advanced security protection – Automatic quarantine blocks Tool Poisoning Attacks until you manually approve new servers.
- Works offline & cross-platform – Native binaries for macOS (Intel & Apple Silicon), Windows (x64 & ARM64), and Linux (x64 & ARM64) with system-tray UI.
Quick Start
1. Install
macOS (Recommended - DMG Installer):
Download the latest DMG installer for your architecture:
- Apple Silicon (M1/M2): Download DMG →
mcpproxy-*-darwin-arm64.dmg - Intel Mac: Download DMG →
mcpproxy-*-darwin-amd64.dmg
Windows (Recommended - Installer):
Download the latest Windows installer for your architecture:
- x64 (64-bit): Download Installer →
mcpproxy-setup-*-amd64.exe - ARM64: Download Installer →
mcpproxy-setup-*-arm64.exe
The installer automatically:
- Installs both
mcpproxy.exe(core server) andmcpproxy-tray.exe(system tray app) to Program Files - Adds MCPProxy to your system PATH for command-line access
- Creates Start Menu shortcuts
- Supports silent installation:
.\mcpproxy-setup.exe /VERYSILENT
Alternative install methods:
macOS (Homebrew):
brew install smart-mcp-proxy/mcpproxy/mcpproxy
Manual download (all platforms):
Prerelease Builds (Latest Features):
Want to try the newest features? Download prerelease builds from the next branch:
- Go to GitHub Actions
- Click the latest successful "Prerelease" workflow run
- Download from Artifacts:
dmg-darwin-arm64(Apple Silicon Macs)dmg-darwin-amd64(Intel Macs)versioned-linux-amd64,versioned-windows-amd64(other platforms)
Note: Prerelease builds are signed and notarized for macOS but contain cutting-edge features that may be unstable.
- macOS: Intel | Apple Silicon
Anywhere with Go 1.22+:
go install github.com/smart-mcp-proxy/mcpproxy-go/cmd/mcpproxy@latest
2. Run
mcpproxy serve # starts HTTP server on :8080 and shows tray
3. Add servers
Edit mcp_config.json (see below). Or ask LLM to add servers (see doc).
4. Connect to your IDE/AI tool
📖 Complete Setup Guide - Detailed instructions for Cursor, VS Code, Claude Desktop, and Goose
Add proxy to Cursor
One-click install into Cursor IDE
[![Install in Cursor IDE](https://img.shields.io/badge/Install_in_Cursor-3e44fe?logo=da