This release enhances configuration management for upstream MCP servers and improves protocol compliance with better handling of deprecated endpoints.
New Features
-
Smart Config Patching (Spec 023): Implemented intelligent configuration patching for upstream servers, allowing granular updates to server settings without replacing entire configurations. This makes it easier to modify specific parameters while preserving existing configuration values.
-
RFC 7396 JSON Merge Patch: Added support for RFC 7396 null-means-remove semantics when patching environment variables and headers. Setting a value to
nullnow properly removes that key from the configuration, providing more intuitive configuration management. -
410 Gone Error Handling: Added proper handling for HTTP 410 Gone responses from deprecated MCP endpoints. The proxy now gracefully detects and reports when upstream servers have permanently removed endpoints, helping users identify outdated integrations.
These updates improve MCPProxy's ability to manage dynamic server configurations and handle evolving MCP server APIs more robustly.
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