Skip to content

v0.41.0

Choose a tag to compare

@github-actions github-actions released this 18 Jun 06:26
· 3 commits to main since this release
9442824

This release enhances configuration management and security features, with improvements to credential handling and macOS compatibility.

New Features

  • Server Edition credential management: Added new credential command group for Server Edition to manage authentication and access credentials via CLI
  • Intelligent configuration status checks: Implemented stat-only configuration status monitoring with on-demand content reads, reducing unnecessary file I/O operations
  • macOS TCC denial detection: Added classification for configuration access issues and automatic remediation guidance when macOS Transparency, Consent, and Control (TCC) permissions are denied

Bug Fixes

  • Credential redaction accuracy: Fixed whitespace handling in secure environment credential redaction to ensure sensitive data is properly masked in logs
  • Docker transport error reporting: Improved Docker container spawn decision logging and corrected transport error labels for more accurate troubleshooting

Improvements

  • Documentation restructure: Streamlined Claude Desktop integration guide (CLAUDE.md) to focus on essential orientation and behavior information, with detailed technical content moved to dedicated documentation sections

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