This release focuses on security improvements and bug fixes for OAuth authentication and quarantine functionality.
Bug Fixes
Security
- Fixed quarantined servers over-reporting available tools in search results
- Search index is now properly purged when quarantine is applied via configuration changes
- Custom credential header names are now redacted in logs to prevent credential leakage
OAuth Authentication
- Loopback callback port now remains stable for static OAuth clients, preventing authentication failures
- Callback dispatch now properly routes by state parameter instead of faking success responses
- Redirect URI configuration is now validated and more easily diagnosable
- Fixed reachability issues with pinned callback ports
Web UI
- Fixed incorrect display of quarantined servers as "faults" - quarantine is a security feature, not an error state
- Resolved three presentation defects affecting the user interface
Desktop App (Personal Edition)
- Eliminated permanent red notification badge that incorrectly persisted on system tray icon
- Reduced badge size to a corner dot for less intrusive notifications
Platform Support
- Unblocked end-to-end testing on Windows platform
These fixes improve security posture by ensuring quarantined servers cannot expose unauthorized tools and by protecting credential information in logs. OAuth reliability improvements address authentication stability issues that affected some deployment configurations.
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