v0.10.9
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):
Windows Installer:
macOS Installer:
This Version (v0.10.9):
Installation
Windows:
- Download the installer for your architecture (AMD64 or ARM64)
- Run
mcpproxy-setup-*.exe - Follow the installation wizard (requires Administrator privileges)
- MCPProxy will be added to Start Menu and system PATH
- Launch "MCPProxy" from Start Menu to start the tray app
- The app will appear in your system tray
macOS:
- Download the signed installer DMG for your Mac (Apple Silicon or Intel)
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- CLI tool
mcpproxywill be available in Terminal - Launch mcpproxy.app from Applications folder
- The app will appear in your system tray
Manual Installation (All Platforms):
- Download the appropriate archive for your platform using the links above
- Extract the archive:
tar -xzf mcpproxy-*.tar.gz(Linux/macOS) or unzip (Windows) - Make it executable:
chmod +x mcpproxy(Linux/macOS) - Run
./mcpproxyto 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)