This release focuses on improving the registry management experience with a redesigned interface and enhanced controls for custom registries.
New Features
Personal Edition (macOS/Desktop):
- Redesigned Registries view with separate Discover and Manage tabs for better organization and discovery-first workflow
- New registry information popup accessible by clicking registry badges
- Added ability to edit and remove custom user-added registries
- Official registries are now read-only to prevent accidental modifications
Teams Edition:
- Added API endpoint for editing registry configurations
- Implemented removal path for custom user-added registries
- Simplified trust and quarantine model for registry management
Both Editions:
- Enhanced custom registry management with improved UI and controls
- Streamlined default registry list to 3 core registries, removing deprecated entries
Bug Fixes
- Fixed URL encoding issue when looking up server IDs containing slashes in registry additions
- Removed alarming warning messages from registry management interface for better user experience
Improvements
- Removed the configured-registries panel in favor of the new tabbed interface
- Better visual distinction between official (read-only) and custom (editable) registries
- Cleaner registry management workflow with consolidated controls
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 key