Skip to content

v0.21.2

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 11 Mar 17:51
· 7 commits to main since this release
v0.21.2
94779d6
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 environment variable and keyring secret reference expansion across all server configuration fields, enhancing security and flexibility for sensitive credentials.

New Features

  • Secret Reference Expansion: All ServerConfig and DataDir fields now support environment variable (${ENV_VAR}) and keyring references (${keyring:service:key}). This allows secure configuration of any field containing sensitive data, including command arguments, environment variables, and working directories.

  • Enhanced Secret Utilities: Added ExpandStructSecretsCollectErrors function for more robust error handling during secret expansion, and exported CopyServerConfig for safer configuration management.

Notes

These features affect both Personal and Teams editions, enabling more secure credential management across all deployment scenarios.

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