Installation Methods

Multiple ways to install MCPProxy on your system. Choose the method that works best for your setup.

Windows Installer (Recommended for Windows)

The easiest way to install MCPProxy on Windows is using our signed installers:

Download Latest Version:

🪟 Windows AMD64
For Windows 10+ (64-bit) • Recommended
🪟 Windows ARM64
For ARM-based Windows devices

⚠️ Note: The Windows installer is currently unsigned. Windows SmartScreen may show a warning when running the installer. Click "More info" and then "Run anyway" to proceed with the installation.

Installation Steps:

  1. Download the appropriate installer for your Windows architecture
  2. Run the mcpproxy-setup-*.exe file
  3. If Windows SmartScreen appears, click "More info" and then "Run anyway"
  4. Follow the installation wizard (requires Administrator privileges)
  5. MCPProxy will be added to Start Menu and system PATH
  6. Launch "MCPProxy" from Start Menu to start the tray app

macOS DMG Installer (Recommended for macOS)

The easiest way to install MCPProxy on macOS is using our signed DMG installers:

Download Latest Version:

🍎 macOS Apple Silicon (ARM64)
For M1/M2/M3/M4 Macs • Recommended
📟 macOS Intel (AMD64) - Legacy
For older Intel-based Macs

Installation Steps:

  1. Download the appropriate DMG file for your Mac architecture
  2. Double-click the DMG file to mount it
  3. Double-click the PKG installer inside
  4. Follow the installation wizard
  5. CLI tool mcpproxy will be available in Terminal
  6. Launch mcpproxy.app from Applications folder

Homebrew Installation

For developers who prefer package managers, MCPProxy is available via Homebrew:

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Then run MCPProxy:

mcpproxy

Note: With the proxy running, learn how to add upstream servers.

Direct Binary Downloads

Pre-compiled binaries are available for all major platforms. These are available in two flavors:

Latest Version (Auto-Updates)

These binaries automatically point to the latest release:

🐧
Linux AMD64
tar.gz
🐧
Linux ARM64
tar.gz
🪟
Windows AMD64
zip
🪟
Windows ARM64
zip
💻
macOS AMD64
tar.gz
💻
macOS ARM64
tar.gz

This Version (v0.11.0)

Download specific version v0.11.0:

🐧
Linux AMD64
tar.gz
🐧
Linux ARM64
tar.gz
🪟
Windows AMD64
zip
🪟
Windows ARM64
zip
💻
macOS AMD64
tar.gz
💻
macOS ARM64
tar.gz

Manual Installation Steps

  1. Download the appropriate archive for your platform using the links above
  2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
  3. Make it executable (Linux/macOS only): chmod +x mcpproxy
  4. Run ./mcpproxy to start

Note: Binary downloads require manual setup. The installer packages (Windows/macOS) or Homebrew installation are recommended for easier setup.

System Requirements

  • macOS: macOS 10.15 (Catalina) or later
  • Windows: Windows 10 or later (64-bit)
  • Linux: Most modern distributions (64-bit)
  • Memory: 256MB RAM minimum, 512MB recommended
  • Disk Space: 50MB for installation

Next Steps

After installation, check out these resources: