Skip to content

Releases: smart-mcp-proxy/mcpproxy-go

v0.38.1

07 Jun 04:24
@github-actions github-actions
v0.38.1
9a74b58
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.38.1 Latest
Latest

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

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
Assets 29

v0.38.0

06 Jun 04:15
@github-actions github-actions
v0.38.0
5d99f7e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.38.0

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

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
Loading

v0.38.0-rc.1

05 Jun 13:19
@github-actions github-actions
v0.38.0-rc.1
ebd5136
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.38.0-rc.1 Pre-release
Pre-release

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):

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
Loading

v0.37.0

04 Jun 16:03
@github-actions github-actions
v0.37.0
5c1462e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.37.0

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

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
Loading

v0.37.0-rc.2

04 Jun 04:38
@github-actions github-actions
v0.37.0-rc.2
206bee3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.37.0-rc.2 Pre-release
Pre-release

mcpproxy v0.37.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.37.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
Loading

v0.36.0

03 Jun 03:48
@github-actions github-actions
v0.36.0
cdf1a0a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.36.0 Pre-release
Pre-release

This release introduces a comprehensive registry system with custom sources and provenance tracking, alongside new usage analytics capabilities for Teams edition.

New Features

Registry Management (Both Editions)

  • User-added custom registries with full provenance and trust model tracking
  • CLI command registry add-source to add custom registry sources
  • Web UI affordance for adding registries with provenance surfacing
  • One-time third-party registry warning dialog
  • Adoption of official MCP registry v0.1 protocol with standardized defaults
  • Registry source provenance now projected onto contracts.Server API
  • Versioned User-Agent for registry requests (Pulse protocol)

Usage Analytics (Teams Edition)

  • New usage charts and analytics dashboard with Overview↔Usage switcher
  • GET /api/v1/activity/usage endpoint for usage data retrieval
  • Complete usage tracking visualization in Dashboard

Security Evaluation

  • --scanners flag to run Docker-bundled security scanners for evaluation
  • Security baseline section added to baseline_v1.json format
  • Evaluation foundation integration with comprehensive security assessment capabilities

Bug Fixes

  • Fixed dashboard usage switcher unit tests (green test suite)
  • Corrected Fleur server protocol designation (stdio, not remote)

Improvements

  • Enhanced registry provenance transparency and trust indicators
  • Improved dashboard navigation with seamless Overview/Usage switching
  • Standardized registry protocol implementation for better compatibility

This release significantly enhances MCPProxy's registry ecosystem, enabling users to safely extend beyond default registries while maintaining full visibility into source provenance and trust levels. Teams users gain powerful new usage analytics for monitoring and optimization.

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
Loading

v0.35.0

01 Jun 15:29
@github-actions github-actions
v0.35.0
bf71028
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.35.0

This release introduces actor-owned usage tracking, registry management improvements, and critical stability fixes for runtime operations.

New Features

  • Usage Analytics & Persistence: Implemented actor-owned usage aggregates with full persistence layer, enabling detailed tracking of resource consumption per actor
  • Pre-truncation Byte Capture: Activity records now capture original request/response byte counts before any truncation occurs, improving usage analytics accuracy
  • Registry Upstream Management: Added easy upstream server addition through new core registry operations with CLI MVP support (US2)

Bug Fixes

  • Runtime Stability: Fixed critical issue where in-flight reconcile actions weren't properly drained before client disconnect, preventing potential data loss and race conditions (MCP-783)
  • Upstream Configuration: Resolved data race in client.Config between DiscoverTools and SetConfig operations that could cause configuration corruption (MCP-770)
  • macOS Personal Edition: Disabled automatic text substitutions in the tray app that were interfering with user input (#538)

Documentation

  • Updated Homebrew installation instructions to reflect current setup process
  • Added Glass Cockpit specification and agent-instruction bundle documentation

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
Loading

v0.34.0

30 May 05:29
@github-actions github-actions
v0.34.0
5453f61
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.34.0

This release brings comprehensive configuration improvements and enhanced security features, with major usability upgrades for macOS users.

New Features

  • Native macOS Settings Editor (Personal Edition) - The macOS tray app now includes a full native settings interface with a REST config editor, making configuration management seamless without needing external tools (#537)

  • Form-Based Settings Page - New user-friendly settings page with form controls, plus PATCH /config endpoint support for partial configuration updates without overwriting entire configs (#536)

  • Output Schema Validation - Tool call responses are now validated against their declared output schemas (MCP Spec 054 Track A), ensuring responses conform to expected formats and catching malformed data early (#525)

  • Output Sanitization Enforcement - Security enhancement that sanitizes all tool outputs at the response chokepoint, providing an additional layer of protection against malicious or malformed content (#535)

Improvements

  • Repaired end-to-end API tests following removal of legacy 'call tool' functionality (#534)

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
Loading

v0.33.5

27 May 07:13
@github-actions github-actions
v0.33.5
93d2153
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.33.5

This release focuses on security enhancements and access control improvements.

Bug Fixes

  • Security token detection: Enhanced detection of GitHub stateless token format (approximately 520 characters) to improve security scanning and prevent credential leaks
  • Agent token scoping: Fixed an issue where direct tools were not properly filtered based on agent token scope, ensuring proper access control enforcement

Edition notes: These fixes apply to both Personal and Teams editions, with the agent token scope filtering being particularly relevant for Teams deployments with multiple users and access controls.

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
Loading

v0.33.4

26 May 05:54
@github-actions github-actions
v0.33.4
a667213
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.33.4

This maintenance release focuses on bug fixes and security improvements, particularly around tool policy enforcement and data integrity.

Bug Fixes

  • Fixed tool approval hash migration - Output schema is now properly included in tool approval hash calculations, ensuring consistent approval tracking across tool updates
  • Fixed direct-mode tool callability enforcement - Tools are now correctly validated for direct execution mode, preventing unauthorized tool invocations
  • Fixed Cisco scanner output handling - Removed hardcoded deepwiki URL from Cisco scanner raw output to prevent data pollution

Improvements

  • Unified tool-policy decision logic - Consolidated quarantine and tool-policy enforcement logic across all entry points for more consistent security behavior and easier maintenance (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
Loading