Skip to content

v0.10.9

Choose a tag to compare

@github-actions github-actions released this 08 Dec 11:49
· 655 commits to main since this release
88c6ed4

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:

  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)