Skip to content

Releases: smart-mcp-proxy/mcpproxy-go

v0.52.0-rc.2

v0.52.0-rc.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 22 Jul 09:35
6f06b4f

mcpproxy v0.52.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.52.0-rc.2):

macOS Installer:

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

v0.52.0-rc.1

v0.52.0-rc.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 21 Jul 14:04
edf4866

mcpproxy v0.52.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.52.0-rc.1):

macOS Installer:

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

v0.51.0

Choose a tag to compare

@github-actions github-actions released this 16 Jul 14:48
2caae06

This release improves daemon detection reliability in the CLI when Unix sockets are unavailable.

Bug Fixes

  • CLI daemon detection fallback: The CLI now automatically falls back to TCP-based daemon detection when Unix socket connections are unavailable, improving compatibility across different system configurations and environments. (Affects both Personal and Teams editions)

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/mcpproxy
Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

Binary archives (this version):


Installation Instructions

Windows

  1. Download the installer for your architecture
  2. Run mcpproxy-setup-*.exe
  3. Follow the installation wizard (requires Administrator privileges)
  4. Launch "MCPProxy" from Start Menu

macOS

  1. Download the signed DMG for your Mac
  2. Double-click the DMG to mount it
  3. Double-click the PKG installer inside
  4. Follow the installation wizard
  5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

  1. Download the appropriate archive
  2. Extract: tar -xzf mcpproxy-*.tar.gz
  3. Make executable: chmod +x mcpproxy
  4. 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

v0.51.0-rc.1

v0.51.0-rc.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Jul 12:59
15458bd

mcpproxy v0.51.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.51.0-rc.1):

macOS Installer:

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

v0.50.0

Choose a tag to compare

@github-actions github-actions released this 14 Jul 07:36
95cfcfe

This release brings improvements to the Personal edition's desktop app experience and registry management, along with important bug fixes.

New Features

  • Start Core when the app opens - Added a new preference in the Personal edition to automatically start the MCPProxy Core service when the application launches, streamlining the startup experience (#847, #410)

Bug Fixes

  • Registry URL validation - Fixed an issue where MCPProxy would incorrectly modify user-added registry URLs by inventing routes. The system now verifies registry sources at the time they're added, ensuring more reliable registry connections (#846, #783)
  • Personal edition test suite - Resolved multiple bugs in the native test suite that were previously being skipped. These fixes improve stability and reliability of the desktop application (#848)

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/mcpproxy
Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

Binary archives (this version):


Installation Instructions

Windows

  1. Download the installer for your architecture
  2. Run mcpproxy-setup-*.exe
  3. Follow the installation wizard (requires Administrator privileges)
  4. Launch "MCPProxy" from Start Menu

macOS

  1. Download the signed DMG for your Mac
  2. Double-click the DMG to mount it
  3. Double-click the PKG installer inside
  4. Follow the installation wizard
  5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

  1. Download the appropriate archive
  2. Extract: tar -xzf mcpproxy-*.tar.gz
  3. Make executable: chmod +x mcpproxy
  4. 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

v0.49.0

Choose a tag to compare

@github-actions github-actions released this 13 Jul 13:58
7f57b36

This release focuses on improving the Web UI's navigation structure and fixing session activity viewing.

Bug Fixes

  • Sessions page: Fixed "View Activity" action to correctly display the selected session's activity instead of showing incorrect or empty results
  • Web UI navigation: Reorganized sidebar structure by moving observability-related pages out of the Workspace section for better clarity and discoverability

These changes apply to MCPProxy Teams edition.


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

v0.49.0-rc.4

v0.49.0-rc.4 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Jul 08:03
7f57b36

mcpproxy v0.49.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.49.0-rc.4):

macOS Installer:

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

v0.49.0-rc.3

v0.49.0-rc.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Jul 06:31
c3ed54f

mcpproxy v0.49.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.49.0-rc.3):

macOS Installer:

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

v0.49.0-rc.2

v0.49.0-rc.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 12 Jul 07:06
590c293

mcpproxy v0.49.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.49.0-rc.2):

macOS Installer:

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

v0.49.0-rc.1

v0.49.0-rc.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 11 Jul 12:00
bb9ea73

mcpproxy v0.49.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.49.0-rc.1):

macOS Installer:

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