MCP CLI 是一个功能丰富的命令行界面,用于与 Model Context Protocol(MCP)服务器交互,帮助用户通过 LLM 完成工具调用与对话管理。默认配置使用 Ollama 和 gpt-oss 推理模型进行本地、注重隐私的操作,无需 API 密钥;也支持 OpenAI、Anthropic、Azure、Google、Groq 等云服务商,以及自定义提供方。
主要能力
- 多种操作模式:聊天模式(流式响应与自动工具使用)、交互模式(命令驱动 shell)、命令模式(适合脚本与管道)、直接命令。
- 高级聊天界面:流式响应、推理过程可视化、并发工具执行、Ctrl+C 智能中断、性能指标、Markdown 渲染、令牌用量跟踪(/usage)、多模态附件、会话持久化与对话导出(Markdown/JSON)。
- 工具系统:自动发现服务器工具、按服务商适配工具名、中间件(超时、重试、指数退避、缓存、熔断)、多种执行策略(进程内、隔离子进程、远程 MCP)、并发执行与完整审计轨迹。
- MCP 应用(SEP-1865):服务器可提供交互式 HTML UI(图表、表格、地图、Markdown 查看器),在浏览器沙箱 iframe 中运行,通过 WebSocket 桥接与 MCP 服务器实时通信,带 _meta.ui 注解的工具调用时自动启动。
- 执行计划(Tier 6):用 /plan 创建、检查、执行可复现的工具调用图;支持模型驱动规划(--plan-tools)、并行批量执行(Kahn BFS 拓扑)、变量解析(${var}、模板字符串)、dry-run、检查点与恢复、与预算/限速守卫集成、DAG ASCII 可视化、失败重规划。
- AI 虚拟内存(实验性,v0.16):--vm 启用操作系统式虚拟内存管理对话上下文,--vm-budget 控制令牌预算,--vm-mode 选择 passive/relaxed/strict,/memory 命令可视化页表与逐出指标,支持多模态 page_fault 与页面导出。
- 实时浏览器仪表盘(--dashboard):Agent 终端、活动流、计划查看器、工具注册表、配置面板、文件上传(含拖拽与剪贴板粘贴)。
- 生产加固:日志密钥自动脱敏、结构化轮转 JSON 日志(--log-file)、每服务器超时、线程安全 OAuth、服务器健康监测(/health)。
- 性能与体验:O(1) 工具查找、LLM 工具元数据缓存、启动进度、会话自动保存、8 种内置主题、跨平台终端管理、上下文感知命令补全。
使用方式
- 前置要求:Python 3.11 或更高版本。本地运行需安装 Ollama(ollama.ai)并拉取默认推理模型:ollama pull gpt-oss。云服务商需设置相应环境变量,如 OPENAI_API_KEY、ANTHROPIC_API_KEY、AZURE_OPENAI_API_KEY 与 AZURE_OPENAI_ENDPOINT、GEMINI_API_KEY、GROQ_API_KEY 等。
- 通过命令行进入聊天、交互或命令模式;可用 /plan、/memory、/sessions、/export、/usage、/health、/attach 等命令。
适用场景与限制
- 适合需要与 MCP 服务器交互、进行工具调用编排、多步任务规划、多模态对话以及本地隐私优先运行的用户。
- 官方资料提供了安装、配置、命令与功能说明,但具体的安装命令、价格、收费与部分平台兼容细节在给定资料中暂未提供,请以官方仓库为准。