Skip to content

Releases: smart-mcp-proxy/mcpproxy-go

v0.24.6

17 Apr 18:14
@github-actions github-actions
v0.24.6
debe26f
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.24.6 Latest
Latest

This release improves the tool quarantine visualization in the UI.

Bug Fixes

  • Tool Quarantine UI Enhancement - The tool quarantine diff view now displays changes in a side-by-side before/after format, making it easier to review and understand modifications to quarantined tools. This 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
Assets 24

v0.24.5

17 Apr 11:32
@github-actions github-actions
v0.24.5
b85e7db

Choose a tag to compare

View all tags
v0.24.5

This maintenance release addresses a macOS system tray issue and includes internal improvements.

Bug Fixes

  • Personal Edition (macOS): Fixed system tray menu to display the correct latest available version when updates are available

Note: This release contains primarily maintenance updates focused on improving stability and development workflow.

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.24.4

15 Apr 06:06
@github-actions github-actions
v0.24.4
6b6dcb3
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.24.4

This maintenance release fixes telemetry metrics and updates the telemetry schema.

Bug Fixes

  • Telemetry: Corrected the docker_status metric reporting and implemented schema v3 additions to improve telemetry data accuracy

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.24.3

13 Apr 18:30
@github-actions github-actions
v0.24.3
f7b7b01
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.24.3

This release improves Linux distribution support with native package formats and enhances Docker compatibility for containerized deployments.

New Features

  • Native Linux packages: MCPProxy now ships as .deb (Debian/Ubuntu) and .rpm (RHEL/Fedora) packages in addition to existing distribution methods, making installation easier across Linux distributions
  • Snap-Docker compatibility: Automatic detection and opt-out of no-new-privileges security restriction on hosts running Docker inside Snap environments, preventing common deployment issues
  • Auto-cleanup of deprecated config: MCPProxy automatically removes outdated configuration fields on startup, keeping your config files clean and preventing warnings from obsolete settings

Bug Fixes

  • Telemetry version normalization: Fixed inconsistent version string formatting in telemetry data to ensure the v prefix is always present

Applies to: Both Personal and Teams editions benefit from all changes in this release.

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.24.2

11 Apr 18:05
@github-actions github-actions
v0.24.2
e1c7e41
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.24.2

This release improves tool schema transparency and fixes credential resolution issues in containerized environments.

New Features

  • Tool result size limits now advertised: All tools now expose maxResultSizeChars in their schema, allowing AI agents to better understand size constraints before making calls (#380)
  • Native arguments schema for tool variants: call_tool_* variant tools now advertise their native args object structure, improving schema clarity for AI agents (#379)

Bug Fixes

  • Fixed Docker credential helper resolution: Shell wrapper now properly captures the login shell's PATH environment, ensuring Docker credential helpers can be found and executed correctly in containerized deployments (#382)
    • Primarily affects Teams edition deployments using Docker

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

  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.24.1

11 Apr 15:12
@github-actions github-actions
v0.24.1
b6dc5ad
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.24.1

This patch release addresses two platform-specific deployment issues affecting macOS and Docker environments.

Bug Fixes

  • Docker: Fixed PATH inheritance issue by wrapping Docker CLI invocations in user shell, ensuring Docker commands can properly locate required binaries (#378)
  • macOS (Personal Edition): Fixed installation on Apple Silicon Macs by ensuring the tray application downloads the correct DMG matching the host CPU architecture (ARM64 vs x86_64) (#377)

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

  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.24.0

11 Apr 12:56
@github-actions github-actions
v0.24.0
12c2095
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.24.0

This release introduces a major new security scanner plugin system and implements privacy-respecting telemetry, along with several important bug fixes.

New Features

  • Security Scanner Plugin System — A comprehensive plugin architecture for scanning MCP servers and tools for security vulnerabilities, enabling extensible security analysis capabilities
  • Telemetry tier 2 — Privacy-respecting usage signals now collected via REST API, requiring daemon for payload viewing. Telemetry configuration now properly honors the --config flag

Bug Fixes

  • Security scanner routing — Non-CVE security findings are now correctly routed outside the Supply Chain Audit section for better organization
  • Quarantine auto-approval — Fixed critical issue where quarantine_enabled=false would incorrectly auto-approve new servers without user review. This affected both editions
  • Feature flag emission — The enable_web_ui flag is now properly emitted alongside enable_prompts in feature flag responses
  • Security scanner QA — Resolved 13 quality assurance findings in the security scanner plugin system, improving reliability and accuracy
  • Homebrew auto-update — Personal edition Homebrew cask now automatically updates on release

Breaking Changes

  • Telemetry payload viewing — The show-payload command now requires the daemon to be running to serve telemetry data via REST instead of direct file access

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

  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.23.2

09 Apr 13:09
@github-actions github-actions
v0.23.2
4204b1e
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.23.2

This patch release fixes a critical issue with media content handling in MCP conversations.

Bug Fixes

  • Fixed media content preservation: ImageContent and AudioContent blocks are now correctly preserved when passing through the proxy, ensuring multimedia content in MCP conversations works properly (#368) (#369)

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

  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.23.1

02 Apr 05:17
@github-actions github-actions
v0.23.1
d98458b
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.23.1

This release focuses on improved connection management and security hardening, with fixes for Windows compatibility and the Teams edition web UI.

New Features

  • On-demand reconnection: Added reconnect_on_use configuration option that automatically reconnects to upstream MCP servers when tools are invoked, enabling more efficient resource usage for intermittently-used servers

Bug Fixes

  • Teams: Fixed Web UI launcher in system tray to use the configured port instead of defaulting to a hardcoded value (#362)
  • Windows compatibility: Resolved connection test failures on Windows related to path prefix handling and file permission checks
  • Added missing GetToolApprovalStatus method to test mocks and storage imports, fixing potential runtime errors

Security & Reliability

  • Enhanced quarantine state machine with formal invariant checking and property-based tests to ensure security guarantees are maintained across all state transitions
  • Fixed a security issue in the quarantine system discovered through property testing

Configuration Note: The new reconnect_on_use option is useful for MCP servers that are expensive to keep running continuously. When enabled, MCPProxy will establish connections only when tools are actually needed, then optionally disconnect afterward to save resources.

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

  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.23.0

01 Apr 05:29
@github-actions github-actions
v0.23.0
c61630c

Choose a tag to compare

View all tags
v0.23.0

MCPProxy v0.23.0 is a major release with 86 commits since v0.22.0, headlined by a fully native macOS desktop app, a comprehensive tool approval security workflow, and an MCP-based UI testing framework.

Native macOS Desktop App

The macOS edition now ships with a native Swift tray app — a full desktop experience built with SwiftUI and AppKit, replacing the previous lightweight tray menu.

  • Docker Desktop-style server management — sortable table with status indicators, context menus, and inline actions (enable/disable, restart, quarantine, OAuth login)
  • Dashboard matching the web UI with server health overview and attention items
  • Activity Log with SSE live updates, colored JSON detail view, intent metadata, and CSV/JSON export
  • Tool diff viewer — inspect description and schema changes for quarantined tools before approving
  • Add/Edit Server dialogs with protocol detection and validation
  • Sidebar navigation with Apple HIG-compliant icons (Dashboard, Servers, Activity, Secrets)
  • Cmd+/Cmd-/Cmd+0 zoom — font-only scaling that preserves panel layouts
  • GitHub Releases update checker with Sparkle integration for auto-updates
  • Health badge notifications with configurable triggers
  • Tray icon with status overlay (green/yellow/red) reflecting aggregate server health
  • Pause/Resume core server directly from the tray menu

Tool Approval & Quarantine Enhancements

  • Tool approval badges — new tools show a "New" badge, changed tools show "Changed" with word-level diff highlighting of what changed in descriptions and schemas
  • Individual tool approval — approve tools one at a time from the macOS tray app or web UI instead of bulk-approving entire servers
  • Enriched /api/v1/servers/{id}/tools API — each tool now includes approval_status field; pending approvals are sorted to the top
  • Annotations in API responses — tool annotations (readOnlyHint, destructiveHint, etc.) are now properly returned and displayed
  • Self-healing hash migration — eliminates false tool_description_changed events caused by legacy hash formats
  • Annotations excluded from quarantine hash — prevents false change alerts when only annotations metadata changes

MCP UI Testing Framework (mcpproxy-ui-test)

New MCP server for automated macOS UI verification:

  • screenshot_window / screenshot_status_bar_menu — capture app windows and tray menus
  • list_menu_items / click_menu_item — read and interact with menu trees
  • read_status_bar / check_accessibility — verify tray state and API permissions
  • list_running_apps — discover running apps by bundle ID

Bug Fixes

  • Critical: auto-approval bypass — changed tools were incorrectly auto-approved during the second checkToolApprovals pass
  • API deadlocks — resolved deadlock in server list endpoint under concurrent access
  • Token savings display — capped at 99.99% instead of showing invalid percentages
  • Docker status — now accurately shows "active" when containers are running
  • Activity live updates — SSE events now trigger real-time refresh in both web UI and tray
  • Navigation — all "Needs Attention" items correctly link to the server detail page
  • Export pagination — activity export respects pagination parameters
  • Annotation filtering — search and filter work correctly with annotated tools
  • Tray log growth — fixed unbounded log growth when the upstream server list is empty

CI/CD

  • Swift tray app now built in CI and bundled into macOS DMG installers
  • Sparkle.framework properly bundled with correct rpath
  • App icon (.icns) included in bundle for Launchpad visibility
  • LaunchAgent executable path fixed for auto-start

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

  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 native desktop app with system tray
  • 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