[0.5.0] — 2026-08-17
Added — Install command + local handler architecture + forwarding layer
-
mcptoon installcommand — One-command MCP server installation with auto-handler generation. Connects to the server, discovers tools, generates a Python handler, and registers it. No restart needed.mcptoon install brave-search --npm @anthropic/mcp-server-brave-search mcptoon install my-tool --pip mcp-my-tool mcptoon install remote-api --url https://example.com/mcp mcptoon install --list mcptoon install --remove brave-search
-
Local handler architecture — Public core (
src/mcptoon/) + private layer (local/) separation. Thelocal/directory contains:cli_pro.py— Enhanced CLI entry point with handler injectionhandlers/— 30+ auto-generated handlers for MCP serversrouter.py— Bridge router that checks local handlers before falling back to MCPdaemon.py— Background daemon for connection poolingcore.py— Remote execution core for SSH-based MCP calls
-
Forwarding layer —
universal_call.pyforwards old CLI commands to the newcli_pro.pyentry point, ensuring zero-disruption migration for existing skills and scripts. -
call --autonow searches local handlers first — Router prioritizes local handlers before MCP servers, ensuring faster response for registered tools. -
Daemon fallback — If daemon fails to start,
callautomatically falls back to single-shot mode for maximum reliability. -
Skill Direct-Invoke mode — Skills can directly call CLI commands without loading MCP schemas into context, achieving 0-token MCP usage.
-
ADR documentation — Architecture Decision Records added in
docs/adr/:0001-cli-mode-over-mcp-protocol.md— Why CLI mode beats MCP protocol injection0002-public-core-private-layer-separation.md— Dual-track architecture decision0003-toon-format-as-primary-output.md— TOON as the default output format0004-forwarding-layer-for-backward-compatibility.md— Forwarding layer for seamless transition
-
E2E test suite — 10/10 tests passing, covering: echo, gbrain search, gbrain list_pages, servers, doctor, manifest, inspect (×2), call --auto, forwarding layer, install --list.
Changed
- Bumped version to 0.5.0
router.pynow checks local handlers before MCP servers incall_tool_autodaemon.pystartup path fixed for Windows, wait time reducedinstaller.pymoved fromlocal/tosrc/mcptoon/(public core)installer.pyadapted to useMCPClientfrom public core
Fixed
- Daemon startup path error on Windows
call --autonot searching local handlersUNKNOWN_SERVERerrors for gbrain, exa, tinyfish, github- Double
try/exceptnesting in handler bridge - SSH remote script path for Windows targets