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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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

v0.22.1-rc.8

This release contains build system fixes for the macOS desktop application, improving the reliability of the build process and auto-update functionality.

Bug Fixes

Personal Edition:

• Fixed build script to resolve OUTPUT_DIR to absolute path before changing directories, preventing potential build failures
• Corrected test workflow path configuration for Swift app bundle verification
• Added @executable_path/../Frameworks to runtime library search path (rpath) to ensure Sparkle auto-update framework loads correctly

---

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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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.22.1-rc.7

This release fixes a critical launch issue in the macOS desktop application.

Bug Fixes

• Personal Edition (macOS): Fixed crash on launch caused by missing Sparkle.framework bundle. The auto-update framework is now properly included in the Swift application bundle.

---

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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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.22.1-rc.6

This release fixes the application icon display on macOS for the Personal edition.

Bug Fixes

• [Personal] Fixed missing application icon in macOS by adding proper CFBundleIconName and CFBundleIconFile entries to Info.plist and bundling the .icns file

---

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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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.22.1-rc.4

This release candidate includes a minor CI/CD pipeline improvement to enhance the reliability of the release process.

Bug Fixes

• Fixed GitHub Actions release workflow to continue building all platform binaries even if one platform fails, ensuring maximum platform coverage for each release

Note: This change affects the build infrastructure and does not impact end-user functionality in either Personal or 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 (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):

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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.22.1-rc.3

This release fixes macOS application visibility and launch issues.

Bug Fixes

• Personal Edition (macOS): Fixed MCPProxy not appearing in Launchpad after installation
• Personal Edition (macOS): Corrected LaunchAgent executable path to ensure proper application launching

---

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

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

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

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