This release focuses on improved connection management and security hardening, with fixes for Windows compatibility and the Teams edition web UI.
New Features
- On-demand reconnection: Added
reconnect_on_useconfiguration option that automatically reconnects to upstream MCP servers when tools are invoked, enabling more efficient resource usage for intermittently-used servers
Bug Fixes
- Teams: Fixed Web UI launcher in system tray to use the configured port instead of defaulting to a hardcoded value (#362)
- Windows compatibility: Resolved connection test failures on Windows related to path prefix handling and file permission checks
- Added missing
GetToolApprovalStatusmethod to test mocks and storage imports, fixing potential runtime errors
Security & Reliability
- Enhanced quarantine state machine with formal invariant checking and property-based tests to ensure security guarantees are maintained across all state transitions
- Fixed a security issue in the quarantine system discovered through property testing
Configuration Note: The new reconnect_on_use option is useful for MCP servers that are expensive to keep running continuously. When enabled, MCPProxy will establish connections only when tools are actually needed, then optionally disconnect afterward to save resources.
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 (AMD64) | Download tar.gz | Binary package |
| Linux (ARM64) | Download tar.gz | For ARM Linux |
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