smart-mcp-proxy/mcpproxy-go v0.13.0 on GitHub

This release focuses on OAuth authentication improvements, enhanced observability, and several UI fixes to improve the user experience.

New Features

Structured Error Feedback for OAuth: OAuth login failures now provide clear, actionable error messages to help users troubleshoot authentication issues more effectively (Spec 020)
Persistent OAuth Callback Port: The OAuth callback port is now persisted across sessions, ensuring consistent redirect URIs and more reliable authentication flows
Request ID Tracking: Added end-to-end request tracing with unique request IDs, making it easier to debug issues and track requests through the entire system (#21)
Unified Server Health State: Implemented structured server state management with health status as the single source of truth, improving reliability and consistency of server monitoring

Bug Fixes

OAuth Browser Window: Fixed issue where the 'auth login' command wasn't properly opening the browser window for OAuth authentication
Clickable Server Names: Server names in attention banners are now properly clickable, improving navigation and usability
Contract File Stability: Removed timestamps from generated contracts.ts to prevent unnecessary file changes and reduce repository churn

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