MCPProxy MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/smart-mcp-proxy/mcpproxy-go
cd mcpproxy-go

Then follow the repository README for any remaining dependency or build steps before continuing.

2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add mcpproxy-go -- node "<FULL_PATH_TO_MCPPROXY_GO>/dist/index.js"

Replace <FULL_PATH_TO_MCPPROXY_GO>/dist/index.js with the actual folder you prepared in step 1.

README.md

Smart proxy for AI agents with tool discovery and security quarantine

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

    

System Tray - Upstream Servers          System Tray - Quarantine Management

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_tools function 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:

The installer automatically:

  • Installs both mcpproxy.exe (core server) and mcpproxy-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:

  1. Go to GitHub Actions
  2. Click the latest successful "Prerelease" workflow run
  3. 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.

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

Tools (1)

retrieve_toolsRetrieves and federates tools from multiple upstream MCP servers to bypass API limits.

Configuration

claude_desktop_config.json
{"mcpServers": {"mcpproxy": {"command": "mcpproxy", "args": ["serve"]}}}

Try it

ā†’List all available tools from my connected MCP servers through the proxy.
ā†’Use the proxy to discover and execute tools from my local file system and database servers.
ā†’Help me manage my upstream MCP servers and check their quarantine status.

Frequently Asked Questions

What are the key features of MCPProxy?

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.

What can I use MCPProxy for?

Developers needing to connect more than 40 tools to Cursor or other AI IDEs. Users wanting to isolate and quarantine untrusted MCP servers before execution. Teams looking to reduce token usage by optimizing tool schema loading. Power users managing multiple local and remote MCP server instances.

How do I install MCPProxy?

Install MCPProxy by running: brew install smart-mcp-proxy/mcpproxy/mcpproxy

What MCP clients work with MCPProxy?

MCPProxy works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep MCPProxy docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all ai-tools servers ā†’

Related MCP Servers

Skill Seekers
The data layer for AI systems.
ai-tools11.1K stars
Context Mode
The other half of the context problem.
ai-tools5.6K stars
Semiotic
A React data visualization library designed for AI-assisted development.
ai-tools2.5K stars
Context+
Semantic Intelligence for Large-Scale Engineering.
ai-tools1.5K stars
ShipSwift
AI-native SwiftUI component library ā€” production-ready code for LLMs
ai-tools1.3K stars
Blitz
Native macOS app for building, testing, and shipping iOS apps with AI agents
ai-tools715 stars