Skip to content

v0.46.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 25 Jun 04:58
v0.46.0
5ed2c30
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 introduces Profiles v2, enabling users to manage multiple MCP server configurations and switch between them dynamically, plus enhanced security isolation options.

New Features

Profiles v2 (Teams edition)

  • Per-profile tool indexes: Each profile now maintains its own Bleve search index for faster, isolated tool discovery
  • Profile switching via MCP tool: Agents can now switch profiles programmatically using the new set_profile MCP tool
  • Profile management REST API: New /api/v1/profiles endpoint for profile CRUD operations
  • Profile pinning per agent token: Pin specific agents to profiles with server-side enforcement to prevent unauthorized profile switching
  • Real-time profile updates: Server-Sent Events (SSE) broadcast active profile changes to connected clients
  • Web UI profile switcher: New header control for selecting active profiles in the dashboard

Profiles v2 (Personal edition)

  • System tray profile switcher: Quick profile switching directly from the macOS/Windows system tray menu

Security & Isolation

  • Configurable isolation modes: New isolation.mode enum setting allows choosing between Docker, Landlock, or no sandboxing
  • Landlock sandbox (experimental): Proof-of-concept Linux kernel-based sandboxing for MCP servers without Docker dependency
  • Per-server initialize timeout: Configure custom MCP protocol initialization timeouts for individual servers to handle slow-starting tools

Bug Fixes

  • Fixed index pagination when rebuilding or clearing per-profile indexes that exceed search page limits

Improvements

  • Mode-aware server selector automatically filters available servers based on configured isolation mode
  • Enhanced observability with proper user_id and profile label values in metrics (Teams edition)

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