Skip to content

v0.40.0

Latest

Choose a tag to compare

@github-actions github-actions released this 17 Jun 13:15
· 1 commit to main since this release
10efe4a

This release focuses on Docker isolation improvements, environment handling for macOS GUI users, and security scan UI reliability fixes.

New Features

  • Environment Variable Forwarding (Teams): New opt-in configuration to forward proxy environment variables to upstream MCP servers for controlled network access (MCP-2769)
  • macOS Login Shell Support (Personal): GUI app now hydrates login-shell environment once at startup, ensuring consistent environment variables when launched via launchd (MCP-2751)
  • Enhanced Telemetry: Added tracking for Docker isolation flag, CLI source identification, and Docker failure codes (schema v5)

Bug Fixes

  • Security Scan UI (Teams): Fixed issue where security scan interface remained stuck on "Scanning…" despite backend job completion (MCP-2740)
  • Scan Cancellation Handling (Teams): Cancelled security scans are now properly treated as non-success states in finalization logic (MCP-2755)
  • Docker Binary Resolution: Improved Docker binary resolution for isolated spawn processes, preventing execution failures in containerized environments (MCP-2753)
  • Docker Path Caching: Fixed stat-probe logic to correctly override negative cache entries in Docker path resolution, improving reliability when Docker becomes available after initial checks

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