Skip to content

v0.15.0

Choose a tag to compare

@github-actions github-actions released this 18 Jan 13:42
· 560 commits to main since this release

This release enhances configuration management and improves OAuth compliance for MCPProxy.

New Features

  • Multi-platform config import: Import MCP server configurations directly from Claude Desktop, Claude Code, Cursor, Codex, and Gemini (Spec 025). Simplifies migration and setup by automatically detecting and importing existing MCP configurations from popular AI development tools.

Bug Fixes

  • OAuth metadata discovery: Implemented RFC 8414 compliant OAuth metadata discovery endpoint, ensuring proper standards compliance for authentication workflows.
  • Homebrew distribution: Updated Homebrew workflow to use pre-built binaries instead of building from source, resulting in faster and more reliable installations for macOS users.

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