Skip to content

Releases: smart-mcp-proxy/mcpproxy-go

v0.22.0

23 Mar 19:13
@github-actions github-actions
v0.22.0
14c1cc9
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.22.0 Latest
Latest

This release enhances MCPProxy's intelligence with improved tool annotations and introduces optional telemetry for better product insights, while addressing test infrastructure stability.

New Features

  • Enhanced Tool Annotations Intelligence - MCPProxy now provides smarter analysis and processing of tool annotations, improving how the proxy understands and presents tool capabilities to AI agents. This enhancement enables better tool discovery and more accurate matching of tools to agent requests.

  • Anonymous Telemetry & In-App Feedback - Optional anonymous usage telemetry and integrated feedback mechanism to help improve MCPProxy. Users can provide feedback directly within the application and optionally share usage patterns to guide future development. All telemetry is anonymous and can be disabled. (Affects both Personal and Teams editions)

Bug Fixes

  • Test Infrastructure - Increased socket E2E server startup timeout to improve test reliability and reduce false failures in automated testing environments.

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

v0.21.3

20 Mar 16:48
@github-actions github-actions
v0.21.3
d5b3d30

Choose a tag to compare

View all tags
v0.21.3

This release focuses on bug fixes and stability improvements, particularly around tool quarantine hashing, configuration handling, and Windows compatibility.

Bug Fixes

  • Tool quarantine hash calculation now includes annotations with backward compatibility to prevent unnecessary re-approval of tools. This fix ensures more accurate tool fingerprinting while maintaining existing approvals.
  • Reduced unnecessary database writes when checking approved tools, improving performance and reducing disk I/O during tool discovery operations.
  • Fixed handling of unresolved secret references in data_dir configuration on Windows, preventing startup errors when environment variables aren't expanded properly.
  • Fixed Windows path escaping in configuration tests to handle backslashes correctly.
  • Fixed retrieve_tools instructions for code execution routing mode to ensure proper tool discovery behavior.
  • Fixed CopyServerConfig missing critical fields (SkipQuarantine and Shared), ensuring complete configuration copying during server setup.

Improvements

  • Added golden test for tool quarantine hash stability to prevent future mass invalidation of approved tools, protecting users from having to re-approve their entire tool library after updates.
  • Automated MCP Registry publishing on release for improved discoverability in the MCP ecosystem.

All fixes apply to both Personal and Teams editions unless otherwise noted.

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
Loading

v0.21.2

11 Mar 17:51
@github-actions github-actions
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.

Choose a tag to compare

View all tags
v0.21.2

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
Loading

v0.21.1

11 Mar 17:31
@github-actions github-actions
v0.21.1
75dd19a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.21.1

This release improves AI agent reliability when using code execution capabilities through better tool descriptions.

Bug Fixes

  • Improved code execution tool description - Enhanced the code_execution tool description to provide clearer guidance to AI agents, improving reliability when agents need to execute code through MCP servers

This change applies to both Personal and Teams editions.

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
Loading

v0.21.0

11 Mar 12:44
@github-actions github-actions
v0.21.0
7db4016
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.21.0 Pre-release
Pre-release

This release introduces tool-level security quarantine and multiple routing modes, enabling safer and more flexible MCP server integration.

New Features

Tool Quarantine System

  • Tools from MCP servers now require explicit approval before execution, protecting against malicious or changed tools
  • Visual tool inspection UI showing tool definitions and changes between versions
  • Automatic approval for trusted servers via skip_quarantine configuration option
  • Quarantine statistics visible in Dashboard, CLI, and server management interfaces
  • Activity logging for all tool approval events
  • New quarantine_security MCP tool for programmatic tool management
  • CLI commands: mcpproxy inspect and mcpproxy approve for tool review

Routing Modes

  • Three distinct routing endpoints with focused tool sets:
    • Direct mode (/mcp/direct): Standard MCP passthrough
    • Call mode (/mcp/call): Includes code_execution tool
    • Code execution mode (/mcp/code_execution): Code execution only
  • Routing mode displayed in status, doctor output, and Web UI
  • Per-mode MCP server instances for isolation

Code Execution Enhancements

  • TypeScript language support added to code_execution tool
  • ES2020+ JavaScript features now supported (upgraded Goja runtime)
  • Simplified tool description for better discoverability

Teams Edition

  • Admin server management with per-user agent tokens
  • OAuth authentication support
  • Multi-user routing with workspace isolation
  • Per-user preferences and activity log isolation
  • Shared server toggle for workspace collaboration
  • Complete UX redesign for multi-user workflows

Bug Fixes

  • Fixed MCP endpoints dropdown not opening due to CSS overflow clipping
  • Resolved stale quarantine counts after tool approval by refreshing server data
  • Auto-approve tools for non-quarantined servers during upgrades
  • Fixed health calculator incorrectly suggesting 'login' for offline non-OAuth servers
  • Reduced tray notification noise by moving server polling to debug level
  • Removed broken Docusaurus internal documentation link

Breaking Changes

  • Product renamed from "Teams" to "Server" edition across all interfaces and documentation

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
Loading

v0.20.2

09 Mar 15:14
@github-actions github-actions
v0.20.2
1f22b71
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.20.2

This release introduces the foundation for MCPProxy Teams edition and includes an important security fix for all users.

Bug Fixes

  • Fixed authentication metadata leak: Resolved a security issue where internal _auth_ metadata could inadvertently leak to upstream MCP servers. All users should update immediately to ensure authentication data remains properly isolated within MCPProxy. (Affects: Personal & Teams editions)

New Features

  • MCPProxy Teams architecture: Introduced the dual-edition architecture separating Personal (desktop) and Teams (multi-user server) codebases. This restructure enables independent development of both editions while sharing core proxy functionality. (Affects: Teams edition - in development)

  • Teams specification added: Published the complete MCPProxy Teams specification defining multi-user capabilities, authentication flows, and server architecture for the upcoming Teams MVP release. (Affects: Teams edition - in development)

Note: MCPProxy Teams edition is currently under active development. This release lays the groundwork for the Teams MVP but does not yet include installable Teams assets. Personal edition users can continue using MCPProxy as normal with the important security fix included in this update.

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
Loading

v0.20.1

08 Mar 06:34
@github-actions github-actions
v0.20.1
83508f5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.20.1

This patch release improves stability and error handling in MCPProxy's core proxy operations.

Bug Fixes

  • Panic Recovery: Fixed panic recovery mechanism to return proper error results instead of causing unexpected behavior. The proxy now gracefully handles runtime panics and converts them into structured error responses.
  • Tokenizer Safety: Added nil pointer protection for tokenizer operations, preventing potential crashes when the tokenizer is not properly initialized during tool processing.

These changes enhance the reliability of MCPProxy when processing requests from AI agents, particularly in edge cases involving malformed requests or resource constraints.

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
Loading

v0.19.1

03 Mar 16:44
@github-actions github-actions
v0.19.1
ed10f89
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.19.1

This patch release fixes OAuth token handling to ensure compatibility with Supabase and other authentication providers that return HTTP 201 status codes.

Bug Fixes

  • OAuth token responses: Fixed normalization of HTTP 201 responses during OAuth token exchange to properly handle Supabase authentication flows. Previously, only HTTP 200 responses were correctly processed, which could cause authentication failures with certain OAuth providers.

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
Loading

v0.19.0

03 Mar 08:38
@github-actions github-actions
v0.19.0
30cb722
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.19.0

Release notes could not be generated automatically. See commit history for changes.

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
Loading

v0.18.1

01 Mar 15:46
@github-actions github-actions
v0.18.1
fac401e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v0.18.1

Release notes could not be generated automatically. See commit history for changes.

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
Loading