mcpdo 是随 @modelcontextprotocol/inspector 软件包与 mcp-inspector 一起发布的实验性命令行客户端。CLI 客户端会连接服务器、运行一次 --method 后断开，而 mcpdo 会连接一次并保持连接打开，因此你可以从任意 shell 针对同一连接运行多条命令，就像 ssh-agent 会持续加载密钥一样。
连接由本地后台守护进程
mcpdod 持有；mcpdo 会按需启动它，并在最后一个连接关闭后退出。你不需要手动启动它。它暴露什么、如何受到保护，请参阅mcpdo 连接守护进程。
观看 mcpdo 教程视频。
安装
mcpdo 是同一软件包中的第二个 bin，因此可以全局安装软件包，或通过 npx -p 运行：
快速入门
mcpdo help 或 mcpdo <command> --help 会打印权威的完整命令和标志列表。
选择要连接的服务器
connect 接受目录条目名称或临时目标：
--config 的行为与其他客户端完全相同（参阅配置和标志）：默认目录是 ~/.mcp-inspector/mcp.json，可以使用 --catalog 或 MCP_CATALOG_PATH 覆盖。servers/list 和 servers/show <name> 从磁盘读取条目。connections/* 显示守护进程当前持有的连接。没有用于编辑目录的命令；请直接编辑文件。
stdio 服务器使用运行 connect 的 shell 的工作目录和命令解析方式，而不是守护进程的工作目录和解析方式，因此相对路径和裸命令名的含义符合预期。
指定连接
目录连接使用条目名称。临时连接默认使用第一个令牌命名（node、docker 或 URL 本身）；也可以在连接时用 @name 命名：
@name 或 --connection <name>（简写为 --conn）指定连接。以 URL 命名的连接只能用 --conn <url> 指定，因为 @name 只接受字母、数字、_、. 和 -：
MCP_ALLOW_DEFAULT_CONNECTION=1 可以允许该回退。
连接具有自我修复能力：传输断开（HTTP 会话过期或 stdio 子进程退出）时，下次使用会使用已存储的凭据透明地重新拨号。只有 auth_required 错误需要你再次运行 connect。
一个连接一次只运行一个调用。其他 shell 中针对它的命令会排在正在执行的调用之后；如果调用停在elicitation上，该连接在回答前会拒绝新调用。长调用不会阻塞其他连接。
任务
要求任务支持的工具不能通过普通tools/call 调用；添加 --task，即可执行带任务增强的调用。命令仍会阻塞到任务完成，然后打印最终结果：
input_required，其问题会像其他elicitation一样处理。
输出
全局标志包括
--format、--plain、--connection / --conn、--catalog / --config 和 --stored-auth-only。它们可以位于子命令之前或之后，但必须位于任意 -- 之前。@name 简写必须位于子命令之前。
绑定终端的文本（结果、elicitation 提示和守护进程错误）会移除控制字符，因此服务器无法改写你的终端。--format json 保持原样。
授权
mcpdo 与其他 Inspector 客户端共享 oauth.json 和机密信息存储，因此已经在其他位置授权过的服务器无需再次提示即可连接。OAuth 在连接时运行。会话中途的升级授权由一次性 CLI 处理，mcpdo 不处理。
需要浏览器登录时，如果 stdin 和 stderr 都不是 TTY（并且没有强制设置
MCP_AUTO_OPEN_ENABLED），connect 会立即以 0 退出，并返回 pendingAuth: true 和 authUrl。将该 URL 转给需要登录的人。对方完成登录后，连接会自动完成：下一条真正针对该连接的命令会完成连接，在此期间 connections/list 会报告 pendingAuthSignedIn。不要为了修复待处理的登录而重新连接。
在没有操作系统钥匙串的主机上，mcpdo 会将令牌存到共享的 secrets.json 文件中，而不是内存中，因为它的命令和守护进程是不同进程。除非提供密钥，否则该文件是明文；请参阅机密信息存储位置。
Elicitation
当服务器在调用中途提出问题（传统版elicitation/create、现代版 MRTR 轮次，或进入 input_required 的任务）：
- 交互式 TTY：
mcpdo会在当前行内提示。表单模式为每个字段显示一个提示，并提供复核步骤；URL 模式打印 URL 并等待你确认已完成。 - 脚本或代理（
--format json或没有 TTY）：命令返回带有elicitationId的elicitationPending，调用会停在守护进程中。你可以从任意 shell 回答：
--elicit off 连接；--elicit url、form 或 both（默认）选择要播发的模式。
协议时代
mcpdo 与其他客户端协商相同的协议时代。connect --era legacy|auto|modern 会覆盖目录条目的 protocolEra，也是为临时目标设置协议时代的唯一方式。connections/list 会为每个连接标记 [legacy] 或 [modern]，connections/show <name> 会显示协商版本、服务器信息、能力，以及服务器被探测时的支持版本列表。
守护进程
默认情况下，你运行
mcpdo 的每个 shell 都共享一个守护进程，因此在一个终端打开的连接可以在另一个终端使用。mcpdo private 会导出 MCP_INSPECTOR_DAEMON_DIR 和 MCP_INSPECTOR_DAEMON_TOKEN，让当前 shell 获得独立的守护进程。这样可以隔离连接，但不能阻止以你的身份运行的其他进程访问它。
守护进程会在最后一个连接关闭约一分钟后退出。升级软件包后，升级前启动的守护进程会继续运行旧代码直到退出，因此升级软件包后请运行 mcpdo daemon stop。
隔离不受信任的 stdio 服务器
守护进程令牌控制谁可以向守护进程发送命令，而不控制服务器可以做什么。stdio 服务器以你的完整用户权限运行。若要限制一个你不完全信任的服务器，请将 stdio 命令放入容器：@sandboxed 时，该连接会被命名为 docker。
根据服务器的需求调整网络和挂载标志。HTTP 和 SSE 服务器不会运行本地代码，因此不需要进程隔离。
环境变量
mcpdo 读取与其他客户端相同的目录、存储和机密信息存储变量（参阅环境变量），以及以下变量：
在编程代理中使用 mcpdo
该软件包附带一个教代理驱动mcpdo 的 agent skill：它持有的连接会扩展代理的工具集，并且知道转交登录 URL 和回答停放的 elicitation。mcpdo agent-help 打印指南，mcpdo agent-help --skill-path 打印可安装 skill 文件的路径，mcpdo agent-help --instructions 打印可附加到项目 CLAUDE.md 或 AGENTS.md 的说明块。