smart-mcp-proxy/mcpproxy-go v0.12.0 on GitHub

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

Download the installer for your architecture
Run mcpproxy-setup-*.exe
Follow the installation wizard (requires Administrator privileges)
Launch "MCPProxy" from Start Menu

macOS

Download the signed DMG for your Mac
Double-click the DMG to mount it
Double-click the PKG installer inside
Follow the installation wizard
Launch mcpproxy.app from Applications folder

Linux / Manual Installation

Download the appropriate archive
Extract: tar -xzf mcpproxy-*.tar.gz
Make executable: chmod +x mcpproxy
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