用途：@mcp-z/cli 让具备 shell 能力的智能体直接复用项目已有的 MCP 配置，在终端中发现和调用 MCP 服务器提供的工具、提示与资源，不必自行编写连接脚本。当项目选择 CLI 访问方式时，应沿用该路径，而非改用智能体原生的 MCP 工具。
运行与配置定位：需要 Node.js 20 或更高版本。一次性运行示例：npx -y @mcp-z/cli inspect --servers SERVER --tools；也可用 npm install -g @mcp-z/cli 全局安装后使用 mcp-z 或别名 z，其余参数一致。SERVER 与 TOOL 为占位符。未指定 --config 时，命令从当前目录向上查找最近的 .mcp.json，直至包含主目录；在主目录树之外仅检查当前目录。配置目录会成为所启动子进程的工作目录。需要指定其他配置或精确路径时使用 --config，如 .mcp.staging.json 向上查找，./.mcp.staging.json 或绝对路径则精确指定。
发现能力：先用任务已有线索，再按需扩展。已知服务器可直接 inspect；能力不熟悉时先搜索，如 mcp-z search "spreadsheet" --servers sheets --types tool --limit 5。发现结果返回服务器自身的实时名称与 schema，应据此调用而非按名称猜测参数。默认输出为可读格式，inspect --tools --json 可获取完整输入 schema。
调用与检查：形式为 mcp-z call-tool SERVER TOOL '{"argument":"value"}' --json，无参数用 '{}'。发现能力不代表获得写入授权，调用应限于用户要求的操作。需检查命令失败与返回数据，成功负载也可能包含逐项失败；结果不确定的写入在重试前应先读取目标。
限制：搜索结果可能因服务器连接失败而不完整，JSON 模式下连接警告会被抑制；使用 mcp-z --help 或 mcp-z COMMAND --help 查看已安装命令的选项。资料未提供更多平台、收费等信息。