smart-mcp-proxy/mcpproxy-go v0.22.1-rc.2 on GitHub

This release candidate focuses on the new native macOS tray application for MCPProxy Personal, featuring a complete redesign with improved UX and system integration.

New Features

macOS Tray App (Personal Edition)

Native Swift tray application with Docker Desktop-style interface
Main application window with sidebar navigation for Dashboard, Servers, Activity Log, and Secrets
Live activity monitoring with SSE-based auto-refresh and color-coded logs
GitHub Releases-based update checker
Expandable tool details with sortable server columns
Activity log export functionality with JSON formatting and intent tracking
Screenshot and accessibility testing capabilities via dedicated MCP server
Font-only zoom controls (Cmd+/Cmd-/Cmd+0) that preserve panel layouts
Health badge notifications and status indicators

Improvements

macOS Tray App (Personal Edition)

Docker Desktop-inspired server table with improved visual hierarchy
Tray menu redesigned with servers submenu, authentication indicators, and accurate status dots for disabled servers
Pause/Resume functionality for the proxy core with icon overlay states
Enhanced Add/Edit Server dialogs with improved UX
Apple-style sidebar icons and macOS Human Interface Guidelines compliance
AppKit NSTableView implementation for better server list performance
Automatic core startup on app launch instead of first menu interaction
Tool change detection now shows detailed diffs in the interface

Bug Fixes

macOS Tray App (Personal Edition)

Resolved API deadlocks and export pagination issues
Fixed OAuth login and server action handlers
Eliminated false tool_description_changed events through self-healing hash migration
Corrected tray icon status display (no longer shows red when servers are healthy)
Fixed server disable operations to use correct /disable endpoint
Stopped unbounded log growth when upstream server list is empty
Resolved socket handling issues for SSE streams and API calls
Fixed version display showing double-v prefix (vv0.22.0 → v0.22.0)
Corrected screenshot and submenu reliability issues

CI/Build

Swift tray app now builds in CI pipeline and integrates into macOS installers
Switched from xcodebuild to swift build with swiftc fallback for improved reliability

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

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

macOS

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

Linux / Manual Installation

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