Skip to content

v0.12.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 07 Jan 18:31
· 587 commits to main since this release
v0.12.0
d31b8ba
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 comprehensive activity logging and observability capabilities, along with a new Intent Declaration system for improved tool organization and LLM interaction.

New Features

  • Activity Log System: Complete activity logging infrastructure tracking all tool calls, server operations, and user actions with real-time monitoring
  • Activity CLI Commands: New commands to view, filter, and analyze activity history:
    • activity list - View all logged activities with filtering by type, server, and date
    • activity show - Display detailed information about specific activities
    • activity watch - Real-time activity monitoring
    • --no-icons flag to disable emoji icons in output
  • Activity Log Web UI: Real-time activity dashboard in the web interface (temporarily disabled pending further testing)
  • Intent Declaration System: Tools can now declare their intended use cases, enabling intelligent tool grouping and improved LLM context management with tool split functionality
  • Server Management CLI: New commands for managing MCP servers:
    • list-servers - View all configured servers
    • search-servers - Search available tools across servers
    • Enhanced table and JSON output formatting
  • Tool Annotations: Added metadata annotations to tools for better LLM understanding and discovery

Bug Fixes

  • Fixed OAuth flow to properly detect empty client_id when Dynamic Client Registration fails with 403 errors
  • Corrected field names in activity watch display output
  • Invalid intent attempts are now properly logged to activity log
  • CLI tool calls now correctly logged with source indicator
  • Search-servers command now outputs table format by default instead of JSON
  • Quarantined servers are now properly excluded from tool discovery and search results
  • Multiple activity CLI bugs resolved based on QA testing

Documentation

  • Added comprehensive documentation for Intent Declaration system (Spec 018)
  • Documented Activity CLI commands with examples and filtering options (Spec 017)
  • Added RFC-003 for Activity Log & Observability architecture

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