This release introduces the foundation for MCPProxy Teams edition and includes an important security fix for all users.
Bug Fixes
- Fixed authentication metadata leak: Resolved a security issue where internal
_auth_metadata could inadvertently leak to upstream MCP servers. All users should update immediately to ensure authentication data remains properly isolated within MCPProxy. (Affects: Personal & Teams editions)
New Features
-
MCPProxy Teams architecture: Introduced the dual-edition architecture separating Personal (desktop) and Teams (multi-user server) codebases. This restructure enables independent development of both editions while sharing core proxy functionality. (Affects: Teams edition - in development)
-
Teams specification added: Published the complete MCPProxy Teams specification defining multi-user capabilities, authentication flows, and server architecture for the upcoming Teams MVP release. (Affects: Teams edition - in development)
Note: MCPProxy Teams edition is currently under active development. This release lays the groundwork for the Teams MVP but does not yet include installable Teams assets. Personal edition users can continue using MCPProxy as normal with the important security fix included in this update.
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