smart-mcp-proxy/mcpproxy-go v0.21.3 on GitHub

This release focuses on bug fixes and stability improvements, particularly around tool quarantine hashing, configuration handling, and Windows compatibility.

Bug Fixes

Tool quarantine hash calculation now includes annotations with backward compatibility to prevent unnecessary re-approval of tools. This fix ensures more accurate tool fingerprinting while maintaining existing approvals.
Reduced unnecessary database writes when checking approved tools, improving performance and reducing disk I/O during tool discovery operations.
Fixed handling of unresolved secret references in data_dir configuration on Windows, preventing startup errors when environment variables aren't expanded properly.
Fixed Windows path escaping in configuration tests to handle backslashes correctly.
Fixed retrieve_tools instructions for code execution routing mode to ensure proper tool discovery behavior.
Fixed CopyServerConfig missing critical fields (SkipQuarantine and Shared), ensuring complete configuration copying during server setup.

Improvements

Added golden test for tool quarantine hash stability to prevent future mass invalidation of approved tools, protecting users from having to re-approve their entire tool library after updates.
Automated MCP Registry publishing on release for improved discoverability in the MCP ecosystem.

All fixes apply to both Personal and Teams editions unless otherwise noted.

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/mcpproxy

Other 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