This release focuses on major UX improvements across both editions, enhanced security scanning capabilities, and improved reliability for upstream MCP server connections.
New Features
- Analytics Dashboard: New default landing page with activity and usage metrics (Teams edition)
- Enhanced Security Scanning:
- Automatic Pass-1 security scan on every server admission with baseline sweep
- New
scan_serverandget_scan_reportAPIs for on-demand security analysis - Server-side secret masking for flagged sensitive data
- Retry-After Support: Proper handling of 429 rate-limit responses from upstream MCP servers with automatic backoff
Bug Fixes
- Web UI (Teams edition):
- Fixed accessibility contrast issues and improved system theme support
- Corrected activity and usage number reporting to show accurate metrics
- Improved server connection state displays and modal accuracy
- Enhanced first-run onboarding experience with clearer call-to-action
- Better form and modal UX across multiple workflows
- Improved mobile layout responsiveness
- macOS Tray (Personal edition):
- Resolved 16 UX issues from settings parity audit
- Fixed
--listenflag forwarding to core process - Corrected port conflict handling and URL semantics for pinned listen addresses
- Marked
code_execution_pool_sizeas restart-required
- Connection Stability: Closed remaining reconnection storm edge cases to prevent excessive retry attempts
- Telemetry: Fixed graceful shutdown to properly flush final heartbeat data
- Security Scanner: Eliminated data races in scanner registry and engine
Improvements
- Streamlined activity counting to ensure consistency between Activity and Usage dashboards
- Updated client retry logic to respect backoff intervals in supervisor reconciliation
- Enhanced update mechanism with improved appcast publishing and unified channel precedence
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