This release adds support for MCP specification 0.4.9 with agent-discoverable disabled tools and introduces layered configuration for tool filtering, plus critical bug fixes for configuration and CI reliability.
New Features
-
Agent-discoverable disabled tools (MCP spec 0.4.9): Tools can now be marked as disabled while remaining discoverable by AI agents. This allows agents to see all available capabilities even when specific tools are administratively restricted, improving context awareness and error handling.
-
Layered tool filter configuration: Introduces a hierarchical configuration system where
config_deniedsettings (administrator-defined restrictions) take precedence over user toggle preferences. This ensures security policies cannot be bypassed by user-level settings. (Teams edition primarily affected)
Bug Fixes
-
Fixed tool status classification: Corrected an issue where server tool status determination was not properly using runtime configuration authority, which could lead to incorrect tool availability states.
-
Fixed configuration snapshot cloning: Deep-copying of tool-filter slices now works correctly in
Snapshot.Clone, preventing potential configuration corruption. Added regression tests to prevent recurrence. -
Eliminated chronic E2E test timeouts: Resolved Docker verification waste in
Runtime.Closethat was causing persistent end-to-end test timeouts in CI pipelines.
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/mcpproxyOther download options (auto-update URLs, archives)
Auto-update URLs (always points to latest):
Binary archives (this version):
Installation Instructions
Windows
- Download the installer for your architecture
- Run
mcpproxy-setup-*.exe - Follow the installation wizard (requires Administrator privileges)
- Launch "MCPProxy" from Start Menu
macOS
- Download the signed DMG for your Mac
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- Launch mcpproxy.app from Applications folder
Linux / Manual Installation
- Download the appropriate archive
- Extract:
tar -xzf mcpproxy-*.tar.gz - Make executable:
chmod +x mcpproxy - 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