Releases: smart-mcp-proxy/mcpproxy-go
Release list
v0.52.0-rc.2
mcpproxy v0.52.0-rc.2 (Prerelease)
Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.
Download Links
This Prerelease (v0.52.0-rc.2):
macOS Installer:
Installation
macOS:
- Download the signed installer DMG for your Mac (Apple Silicon or Intel)
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- CLI tool
mcpproxywill be available in Terminal - Launch mcpproxy.app from Applications folder
- The app will appear in your system tray
Manual Installation (All Platforms):
- Download the appropriate archive for your platform using the links above
- Extract the archive:
tar -xzf mcpproxy-*.tar.gz(Linux/macOS) or unzip (Windows) - Make it executable:
chmod +x mcpproxy(Linux/macOS) - Run
./mcpproxyto start
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (no system tray due to compatibility)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
- Start core server:
mcpproxy serve - Custom port:
mcpproxy serve --listen 127.0.0.1:8081 - Set API key:
export MCPPROXY_API_KEY=your-secret-key - Start tray separately:
mcpproxy-tray(if core already running)
⚠️ Prerelease Notes
- This is a development version and may contain bugs
- Not recommended for production use
- Auto-updater will NOT automatically update to this version unless
MCPPROXY_ALLOW_PRERELEASE_UPDATES=trueis set
v0.52.0-rc.1
mcpproxy v0.52.0-rc.1 (Prerelease)
Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.
Download Links
This Prerelease (v0.52.0-rc.1):
macOS Installer:
Installation
macOS:
- Download the signed installer DMG for your Mac (Apple Silicon or Intel)
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- CLI tool
mcpproxywill be available in Terminal - Launch mcpproxy.app from Applications folder
- The app will appear in your system tray
Manual Installation (All Platforms):
- Download the appropriate archive for your platform using the links above
- Extract the archive:
tar -xzf mcpproxy-*.tar.gz(Linux/macOS) or unzip (Windows) - Make it executable:
chmod +x mcpproxy(Linux/macOS) - Run
./mcpproxyto start
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (no system tray due to compatibility)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
- Start core server:
mcpproxy serve - Custom port:
mcpproxy serve --listen 127.0.0.1:8081 - Set API key:
export MCPPROXY_API_KEY=your-secret-key - Start tray separately:
mcpproxy-tray(if core already running)
⚠️ Prerelease Notes
- This is a development version and may contain bugs
- Not recommended for production use
- Auto-updater will NOT automatically update to this version unless
MCPPROXY_ALLOW_PRERELEASE_UPDATES=trueis set
v0.51.0
This release improves daemon detection reliability in the CLI when Unix sockets are unavailable.
Bug Fixes
- CLI daemon detection fallback: The CLI now automatically falls back to TCP-based daemon detection when Unix socket connections are unavailable, improving compatibility across different system configurations and environments. (Affects both Personal and Teams editions)
Download Installers
| Platform | Download | Notes |
|---|---|---|
| macOS (Apple Silicon) | Download DMG | Signed & Notarized - Recommended for M1/M2/M3/M4 |
| macOS (Intel) | Download DMG | Signed & Notarized |
| Windows (64-bit) | Download Setup | Setup wizard |
| Windows (ARM64) | Download Setup | For ARM Windows devices |
| Linux Debian/Ubuntu (AMD64) | Download .deb | sudo apt install ./mcpproxy_*.deb |
| Linux Debian/Ubuntu (ARM64) | Download .deb | For ARM64 (Raspberry Pi etc.) |
| Linux Fedora/RHEL (AMD64) | Download .rpm | sudo dnf install ./mcpproxy-*.rpm |
| Linux Fedora/RHEL (ARM64) | Download .rpm | For ARM64 |
| Linux (AMD64) — tarball | Download tar.gz | Binary only |
| Linux (ARM64) — tarball | Download tar.gz | Binary only |
Homebrew (macOS/Linux):
brew install smart-mcp-proxy/mcpproxy/mcpproxyOther download options (auto-update URLs, archives)
Auto-update URLs (always points to latest):
Binary archives (this version):
Installation Instructions
Windows
- Download the installer for your architecture
- Run
mcpproxy-setup-*.exe - Follow the installation wizard (requires Administrator privileges)
- Launch "MCPProxy" from Start Menu
macOS
- Download the signed DMG for your Mac
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- Launch mcpproxy.app from Applications folder
Linux / Manual Installation
- Download the appropriate archive
- Extract:
tar -xzf mcpproxy-*.tar.gz - Make executable:
chmod +x mcpproxy - Run:
./mcpproxy serve
Platform Support & Usage
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (CLI)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
mcpproxy serve # Start server
mcpproxy serve --listen 127.0.0.1:8081 # Custom port
export MCPPROXY_API_KEY=your-secret-key # Set API keyv0.51.0-rc.1
mcpproxy v0.51.0-rc.1 (Prerelease)
Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.
Download Links
This Prerelease (v0.51.0-rc.1):
macOS Installer:
Installation
macOS:
- Download the signed installer DMG for your Mac (Apple Silicon or Intel)
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- CLI tool
mcpproxywill be available in Terminal - Launch mcpproxy.app from Applications folder
- The app will appear in your system tray
Manual Installation (All Platforms):
- Download the appropriate archive for your platform using the links above
- Extract the archive:
tar -xzf mcpproxy-*.tar.gz(Linux/macOS) or unzip (Windows) - Make it executable:
chmod +x mcpproxy(Linux/macOS) - Run
./mcpproxyto start
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (no system tray due to compatibility)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
- Start core server:
mcpproxy serve - Custom port:
mcpproxy serve --listen 127.0.0.1:8081 - Set API key:
export MCPPROXY_API_KEY=your-secret-key - Start tray separately:
mcpproxy-tray(if core already running)
⚠️ Prerelease Notes
- This is a development version and may contain bugs
- Not recommended for production use
- Auto-updater will NOT automatically update to this version unless
MCPPROXY_ALLOW_PRERELEASE_UPDATES=trueis set
v0.50.0
This release brings improvements to the Personal edition's desktop app experience and registry management, along with important bug fixes.
New Features
- Start Core when the app opens - Added a new preference in the Personal edition to automatically start the MCPProxy Core service when the application launches, streamlining the startup experience (#847, #410)
Bug Fixes
- Registry URL validation - Fixed an issue where MCPProxy would incorrectly modify user-added registry URLs by inventing routes. The system now verifies registry sources at the time they're added, ensuring more reliable registry connections (#846, #783)
- Personal edition test suite - Resolved multiple bugs in the native test suite that were previously being skipped. These fixes improve stability and reliability of the desktop application (#848)
Download Installers
| Platform | Download | Notes |
|---|---|---|
| macOS (Apple Silicon) | Download DMG | Signed & Notarized - Recommended for M1/M2/M3/M4 |
| macOS (Intel) | Download DMG | Signed & Notarized |
| Windows (64-bit) | Download Setup | Setup wizard |
| Windows (ARM64) | Download Setup | For ARM Windows devices |
| Linux Debian/Ubuntu (AMD64) | Download .deb | sudo apt install ./mcpproxy_*.deb |
| Linux Debian/Ubuntu (ARM64) | Download .deb | For ARM64 (Raspberry Pi etc.) |
| Linux Fedora/RHEL (AMD64) | Download .rpm | sudo dnf install ./mcpproxy-*.rpm |
| Linux Fedora/RHEL (ARM64) | Download .rpm | For ARM64 |
| Linux (AMD64) — tarball | Download tar.gz | Binary only |
| Linux (ARM64) — tarball | Download tar.gz | Binary only |
Homebrew (macOS/Linux):
brew install smart-mcp-proxy/mcpproxy/mcpproxyOther download options (auto-update URLs, archives)
Auto-update URLs (always points to latest):
Binary archives (this version):
Installation Instructions
Windows
- Download the installer for your architecture
- Run
mcpproxy-setup-*.exe - Follow the installation wizard (requires Administrator privileges)
- Launch "MCPProxy" from Start Menu
macOS
- Download the signed DMG for your Mac
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- Launch mcpproxy.app from Applications folder
Linux / Manual Installation
- Download the appropriate archive
- Extract:
tar -xzf mcpproxy-*.tar.gz - Make executable:
chmod +x mcpproxy - Run:
./mcpproxy serve
Platform Support & Usage
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (CLI)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
mcpproxy serve # Start server
mcpproxy serve --listen 127.0.0.1:8081 # Custom port
export MCPPROXY_API_KEY=your-secret-key # Set API keyv0.49.0
This release focuses on improving the Web UI's navigation structure and fixing session activity viewing.
Bug Fixes
- Sessions page: Fixed "View Activity" action to correctly display the selected session's activity instead of showing incorrect or empty results
- Web UI navigation: Reorganized sidebar structure by moving observability-related pages out of the Workspace section for better clarity and discoverability
These changes apply to MCPProxy Teams edition.
Download Installers
| Platform | Download | Notes |
|---|---|---|
| macOS (Apple Silicon) | Download DMG | Signed & Notarized - Recommended for M1/M2/M3/M4 |
| macOS (Intel) | Download DMG | Signed & Notarized |
| Windows (64-bit) | Download Setup | Setup wizard |
| Windows (ARM64) | Download Setup | For ARM Windows devices |
| Linux Debian/Ubuntu (AMD64) | Download .deb | sudo apt install ./mcpproxy_*.deb |
| Linux Debian/Ubuntu (ARM64) | Download .deb | For ARM64 (Raspberry Pi etc.) |
| Linux Fedora/RHEL (AMD64) | Download .rpm | sudo dnf install ./mcpproxy-*.rpm |
| Linux Fedora/RHEL (ARM64) | Download .rpm | For ARM64 |
| Linux (AMD64) — tarball | Download tar.gz | Binary only |
| Linux (ARM64) — tarball | Download tar.gz | Binary only |
Homebrew (macOS/Linux):
brew install smart-mcp-proxy/mcpproxy/mcpproxyv0.49.0-rc.4
mcpproxy v0.49.0-rc.4 (Prerelease)
Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.
Download Links
This Prerelease (v0.49.0-rc.4):
macOS Installer:
Installation
macOS:
- Download the signed installer DMG for your Mac (Apple Silicon or Intel)
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- CLI tool
mcpproxywill be available in Terminal - Launch mcpproxy.app from Applications folder
- The app will appear in your system tray
Manual Installation (All Platforms):
- Download the appropriate archive for your platform using the links above
- Extract the archive:
tar -xzf mcpproxy-*.tar.gz(Linux/macOS) or unzip (Windows) - Make it executable:
chmod +x mcpproxy(Linux/macOS) - Run
./mcpproxyto start
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (no system tray due to compatibility)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
- Start core server:
mcpproxy serve - Custom port:
mcpproxy serve --listen 127.0.0.1:8081 - Set API key:
export MCPPROXY_API_KEY=your-secret-key - Start tray separately:
mcpproxy-tray(if core already running)
⚠️ Prerelease Notes
- This is a development version and may contain bugs
- Not recommended for production use
- Auto-updater will NOT automatically update to this version unless
MCPPROXY_ALLOW_PRERELEASE_UPDATES=trueis set
v0.49.0-rc.3
mcpproxy v0.49.0-rc.3 (Prerelease)
Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.
Download Links
This Prerelease (v0.49.0-rc.3):
macOS Installer:
Installation
macOS:
- Download the signed installer DMG for your Mac (Apple Silicon or Intel)
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- CLI tool
mcpproxywill be available in Terminal - Launch mcpproxy.app from Applications folder
- The app will appear in your system tray
Manual Installation (All Platforms):
- Download the appropriate archive for your platform using the links above
- Extract the archive:
tar -xzf mcpproxy-*.tar.gz(Linux/macOS) or unzip (Windows) - Make it executable:
chmod +x mcpproxy(Linux/macOS) - Run
./mcpproxyto start
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (no system tray due to compatibility)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
- Start core server:
mcpproxy serve - Custom port:
mcpproxy serve --listen 127.0.0.1:8081 - Set API key:
export MCPPROXY_API_KEY=your-secret-key - Start tray separately:
mcpproxy-tray(if core already running)
⚠️ Prerelease Notes
- This is a development version and may contain bugs
- Not recommended for production use
- Auto-updater will NOT automatically update to this version unless
MCPPROXY_ALLOW_PRERELEASE_UPDATES=trueis set
v0.49.0-rc.2
mcpproxy v0.49.0-rc.2 (Prerelease)
Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.
Download Links
This Prerelease (v0.49.0-rc.2):
macOS Installer:
Installation
macOS:
- Download the signed installer DMG for your Mac (Apple Silicon or Intel)
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- CLI tool
mcpproxywill be available in Terminal - Launch mcpproxy.app from Applications folder
- The app will appear in your system tray
Manual Installation (All Platforms):
- Download the appropriate archive for your platform using the links above
- Extract the archive:
tar -xzf mcpproxy-*.tar.gz(Linux/macOS) or unzip (Windows) - Make it executable:
chmod +x mcpproxy(Linux/macOS) - Run
./mcpproxyto start
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (no system tray due to compatibility)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
- Start core server:
mcpproxy serve - Custom port:
mcpproxy serve --listen 127.0.0.1:8081 - Set API key:
export MCPPROXY_API_KEY=your-secret-key - Start tray separately:
mcpproxy-tray(if core already running)
⚠️ Prerelease Notes
- This is a development version and may contain bugs
- Not recommended for production use
- Auto-updater will NOT automatically update to this version unless
MCPPROXY_ALLOW_PRERELEASE_UPDATES=trueis set
v0.49.0-rc.1
mcpproxy v0.49.0-rc.1 (Prerelease)
Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.
Download Links
This Prerelease (v0.49.0-rc.1):
macOS Installer:
Installation
macOS:
- Download the signed installer DMG for your Mac (Apple Silicon or Intel)
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- CLI tool
mcpproxywill be available in Terminal - Launch mcpproxy.app from Applications folder
- The app will appear in your system tray
Manual Installation (All Platforms):
- Download the appropriate archive for your platform using the links above
- Extract the archive:
tar -xzf mcpproxy-*.tar.gz(Linux/macOS) or unzip (Windows) - Make it executable:
chmod +x mcpproxy(Linux/macOS) - Run
./mcpproxyto start
Platform Support
- macOS: Full system tray support with menu and icons
- Windows: Full system tray support with menu and icons
- Linux: Headless mode only (no system tray due to compatibility)
Usage
GUI (Recommended):
- Launch mcpproxy.app from Applications (auto-starts core server)
- Manages server via system tray menu
CLI:
- Start core server:
mcpproxy serve - Custom port:
mcpproxy serve --listen 127.0.0.1:8081 - Set API key:
export MCPPROXY_API_KEY=your-secret-key - Start tray separately:
mcpproxy-tray(if core already running)
⚠️ Prerelease Notes
- This is a development version and may contain bugs
- Not recommended for production use
- Auto-updater will NOT automatically update to this version unless
MCPPROXY_ALLOW_PRERELEASE_UPDATES=trueis set