mcpproxy v0.39.0-rc.6 (Prerelease)

⚠️ This is a prerelease version - Use at your own risk!

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

This Prerelease (v0.39.0-rc.6):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

Installation

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

⚠️ Prerelease Notes

• This is a development version and may contain bugs
• Not recommended for production use
• Auto-updater will NOT automatically update to this version unless MCPPROXY_ALLOW_PRERELEASE_UPDATES=true is set

mcpproxy v0.39.0-rc.5 (Prerelease)

⚠️ This is a prerelease version - Use at your own risk!

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

This Prerelease (v0.39.0-rc.5):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

Installation

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

⚠️ Prerelease Notes

• This is a development version and may contain bugs
• Not recommended for production use
• Auto-updater will NOT automatically update to this version unless MCPPROXY_ALLOW_PRERELEASE_UPDATES=true is set

mcpproxy v0.39.0-rc.4 (Prerelease)

⚠️ This is a prerelease version - Use at your own risk!

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

This Prerelease (v0.39.0-rc.4):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

Installation

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

⚠️ Prerelease Notes

• This is a development version and may contain bugs
• Not recommended for production use
• Auto-updater will NOT automatically update to this version unless MCPPROXY_ALLOW_PRERELEASE_UPDATES=true is set

mcpproxy v0.39.0-rc.3 (Prerelease)

⚠️ This is a prerelease version - Use at your own risk!

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

This Prerelease (v0.39.0-rc.3):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

Installation

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

⚠️ Prerelease Notes

• This is a development version and may contain bugs
• Not recommended for production use
• Auto-updater will NOT automatically update to this version unless MCPPROXY_ALLOW_PRERELEASE_UPDATES=true is set

mcpproxy v0.39.0-rc.2 (Prerelease)

⚠️ This is a prerelease version - Use at your own risk!

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

This Prerelease (v0.39.0-rc.2):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

Installation

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

⚠️ Prerelease Notes

• This is a development version and may contain bugs
• Not recommended for production use
• Auto-updater will NOT automatically update to this version unless MCPPROXY_ALLOW_PRERELEASE_UPDATES=true is set

mcpproxy v0.39.0-rc.1 (Prerelease)

⚠️ This is a prerelease version - Use at your own risk!

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

This Prerelease (v0.39.0-rc.1):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

Installation

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

⚠️ Prerelease Notes

• This is a development version and may contain bugs
• Not recommended for production use
• Auto-updater will NOT automatically update to this version unless MCPPROXY_ALLOW_PRERELEASE_UPDATES=true is set

This release focuses on bug fixes and quality assurance improvements for the macOS Personal edition.

Bug Fixes

• Personal Edition (macOS): Fixed tri-state duration fields in the system tray Settings interface that were not properly handling all input states. This update also introduces a mandatory QA merge gate to prevent similar issues in future releases.

Download Installers

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

mcpproxy serve # Start server
mcpproxy serve --listen 127.0.0.1:8081 # Custom port
export MCPPROXY_API_KEY=your-secret-key # Set API key

This release enhances server monitoring capabilities with configurable health check intervals and ping-based liveness detection.

New Features

• Configurable Health Check Intervals - Server discovery and health check intervals can now be customized, allowing you to fine-tune how frequently MCPProxy monitors MCP server availability and responsiveness
• Ping-based Liveness Detection - Added ping liveness checks to more accurately detect when MCP servers become unresponsive, improving reliability and failover behavior

These improvements apply to both Personal and Teams editions, providing better control over resource usage and more reliable server monitoring in production environments.

Download Installers

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

mcpproxy serve # Start server
mcpproxy serve --listen 127.0.0.1:8081 # Custom port
export MCPPROXY_API_KEY=your-secret-key # Set API key

mcpproxy v0.38.0-rc.1 (Prerelease)

⚠️ This is a prerelease version - Use at your own risk!

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

This Prerelease (v0.38.0-rc.1):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

Installation

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

⚠️ Prerelease Notes

• This is a development version and may contain bugs
• Not recommended for production use
• Auto-updater will NOT automatically update to this version unless MCPPROXY_ALLOW_PRERELEASE_UPDATES=true is set

This release focuses on improving the registry management experience with a redesigned interface and enhanced controls for custom registries.

New Features

Personal Edition (macOS/Desktop):

• Redesigned Registries view with separate Discover and Manage tabs for better organization and discovery-first workflow
• New registry information popup accessible by clicking registry badges
• Added ability to edit and remove custom user-added registries
• Official registries are now read-only to prevent accidental modifications

Teams Edition:

• Added API endpoint for editing registry configurations
• Implemented removal path for custom user-added registries
• Simplified trust and quarantine model for registry management

Both Editions:

• Enhanced custom registry management with improved UI and controls
• Streamlined default registry list to 3 core registries, removing deprecated entries

Bug Fixes

• Fixed URL encoding issue when looking up server IDs containing slashes in registry additions
• Removed alarming warning messages from registry management interface for better user experience

Improvements

• Removed the configured-registries panel in favor of the new tabbed interface
• Better visual distinction between official (read-only) and custom (editable) registries
• Cleaner registry management workflow with consolidated controls

Download Installers

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

mcpproxy serve # Start server
mcpproxy serve --listen 127.0.0.1:8081 # Custom port
export MCPPROXY_API_KEY=your-secret-key # Set API key