Skip to content

v0.24.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 11 Apr 18:05
· 187 commits to main since this release
v0.24.2
e1c7e41
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

This release improves tool schema transparency and fixes credential resolution issues in containerized environments.

New Features

  • Tool result size limits now advertised: All tools now expose maxResultSizeChars in their schema, allowing AI agents to better understand size constraints before making calls (#380)
  • Native arguments schema for tool variants: call_tool_* variant tools now advertise their native args object structure, improving schema clarity for AI agents (#379)

Bug Fixes

  • Fixed Docker credential helper resolution: Shell wrapper now properly captures the login shell's PATH environment, ensuring Docker credential helpers can be found and executed correctly in containerized deployments (#382)
    • Primarily affects Teams edition deployments using Docker

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
Assets 20
Loading