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
SignPath

Free code signing on Windows provided by SignPath.io, certificate by SignPath Foundation.

Installation Steps:

  1. Download the appropriate installer for your Windows architecture
  2. Run the mcpproxy-setup-*.exe file
  3. Follow the installation wizard (requires Administrator privileges)
  4. MCPProxy will be added to Start Menu and system PATH
  5. 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

Arch Linux — AUR (community-maintained)

MCPProxy is available on the Arch User Repository as mcpproxy-bin, which installs the official upstream binary plus a hardened systemd unit.

With an AUR helper (recommended)

yay -S mcpproxy-bin

Or manually with makepkg

git clone https://aur.archlinux.org/mcpproxy-bin.git
cd mcpproxy-bin
makepkg -si

The package installs mcpproxy to /usr/bin and ships a systemd user unit at /usr/lib/systemd/user/mcpproxy.service. Enable it with systemctl --user enable --now mcpproxy.

Update cadence: unlike the apt/dnf repositories above, AUR is community-driven. New versions land via the mcpproxy-bin PKGBUILD being bumped, not via a project-controlled mirror. The package is currently kept current by automation in the maintainer's updater repo, so bumps usually appear within a day of a GitHub release. If yay reports an old version after a recent release, you can flag the package "out-of-date" on AUR or fall back to the tarball install below.

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.38.1)

Download specific version v0.38.1:

🐧
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: