This release focuses on Docker isolation improvements, environment handling for macOS GUI users, and security scan UI reliability fixes.
New Features
- Environment Variable Forwarding (Teams): New opt-in configuration to forward proxy environment variables to upstream MCP servers for controlled network access (MCP-2769)
- macOS Login Shell Support (Personal): GUI app now hydrates login-shell environment once at startup, ensuring consistent environment variables when launched via launchd (MCP-2751)
- Enhanced Telemetry: Added tracking for Docker isolation flag, CLI source identification, and Docker failure codes (schema v5)
Bug Fixes
- Security Scan UI (Teams): Fixed issue where security scan interface remained stuck on "Scanning…" despite backend job completion (MCP-2740)
- Scan Cancellation Handling (Teams): Cancelled security scans are now properly treated as non-success states in finalization logic (MCP-2755)
- Docker Binary Resolution: Improved Docker binary resolution for isolated spawn processes, preventing execution failures in containerized environments (MCP-2753)
- Docker Path Caching: Fixed stat-probe logic to correctly override negative cache entries in Docker path resolution, improving reliability when Docker becomes available after initial checks
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