chrishayuk/mcp-cli

MCP CLI - Model Context Protocol Command Line Interface

A powerful, feature-rich command-line interface for interacting with Model Context Protocol servers. This client enables seamless communication with LLMs through integration with the CHUK Tool Processor and CHUK-LLM, providing tool usage, conversation management, and multiple operational modes.

Default Configuration: MCP CLI defaults to using Ollama with the gpt-oss reasoning model for local, privacy-focused operation without requiring API keys.

🆕 Recent Updates (v0.16)

AI Virtual Memory (Experimental)

• --vm flag: Enable OS-style virtual memory for conversation context management, powered by chuk-ai-session-manager
• --vm-budget: Control token budget for conversation events (system prompt is uncapped on top), forcing earlier eviction and page creation
• --vm-mode: Choose VM mode — passive (runtime-managed, default), relaxed (VM-aware conversation), or strict (model-driven paging with tools)
• /memory command: Visualize VM state during conversations — page table, working set utilization, eviction metrics, TLB stats (aliases: /vm, /mem)
• Multimodal page_fault: Image pages return multi-block content (text + image_url) so multimodal models can re-analyze recalled images
• /memory page <id> --download: Export page content to local files with modality-aware extensions (.txt, .json, .png)