MCPProxy v0.10.12 Release Notes

This release adds OAuth 2.0 resource parameter support and resolves API documentation issues.

New Features

• OAuth Resource Parameter Auto-detection: MCPProxy now automatically detects and handles RFC 8707 resource parameters during OAuth flows, improving compatibility with authorization servers that implement resource indicators (#188)

Bug Fixes

• API Documentation: Fixed Swagger/OpenAPI annotations by adding the correct /api/v1 prefix and updated end-to-end tests to ensure API documentation remains accurate (#186)

mcpproxy v0.10.12

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.12):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.10.11 Release Notes

This is a bug fix release that resolves issues with updating server configuration parameters through patch and update operations.

Bug Fixes

• Fixed an issue where env_json, args_json, and headers_json fields could not be properly updated when modifying MCP server configurations through PATCH/UPDATE API operations

mcpproxy v0.10.11

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.11):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.10.10

This release focuses on improving the HTTP server user interface with clearer action labeling and better user experience.

Bug Fixes

• Improved HTTP server UI clarity by replacing "Restart" with "Login" button and using "Reconnect" in the Actions menu for more intuitive navigation

mcpproxy v0.10.10

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.10):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.10.9 Release Notes

This release focuses on comprehensive OAuth improvements, including enhanced token management, automatic refresh capabilities, and a more streamlined authentication experience.

New Features

• AI-Powered Release Notes: Integrated Claude API to automatically generate release notes from commit history
• Proactive OAuth Token Refresh: Added automatic token refresh before expiration and new logout commands for better session management
• OAuth Extra Parameters: Support for custom OAuth parameters with zero-configuration features for easier setup
• OAuth E2E Testing: Comprehensive end-to-end testing suite using Playwright to ensure OAuth reliability

Bug Fixes

• OAuth Flow Optimization: Skip redundant browser OAuth flows when a valid token already exists in storage
• Token Grace Period: Properly handle grace periods for short-lived OAuth tokens to prevent premature expiration
• OAuth Error Handling: Clear OAuth errors automatically on successful reconnection for better user experience
• Token Refresh Stability:
  • Persist Dynamic Client Registration (DCR) credentials to enable proper OAuth token refresh
  • Resolve coordination issues between token refresh operations and OAuth flows
• UI Consistency: Made Login button styling consistent with other server action buttons
• API Response Completeness: Fixed OAuth configuration extraction in API responses to include all necessary fields
• Cross-Platform Testing: Resolved Windows-specific issues with security test checks using proper bash shell configuration
• Race Condition: Fixed race condition in Unix socket E2E tests when running with race detector

Improvements

• Token Status Visibility: Enhanced OAuth token status displays throughout the application
• PR Workflow: Improved CI/CD workflows with better artifact comment handling and permission management for fork PRs

mcpproxy v0.10.9

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.9):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

mcpproxy v0.10.8

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.8):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

mcpproxy v0.10.7

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.7):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

mcpproxy v0.10.6

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.6):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

mcpproxy v0.10.5

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.5):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

mcpproxy v0.10.3

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.3):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

mcpproxy v0.10.2

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.2):

• Linux AMD64
• Linux ARM64
• Windows AMD64
• Windows ARM64
• macOS AMD64
• macOS ARM64

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)