Skip to main content
TUI 是 Inspector 的终端界面,提供与 Web 客户端相同的工具、资源和提示的交互式探索功能。您可以通过 SSH 在远程主机上使用它,也可以在受限环境中使用,或者在您更喜欢留在终端中时使用。

TUI 已连接到服务器,当前位于工具选项卡,显示某个工具的输入架构。

选择服务器

与 CLI 不同,TUI 没有用于选择单个条目的 --server <name> 标志;它会从目录或配置文件中读取服务器,加载其中的每台服务器,并让你从屏幕上的列表中进行选择:
如果既未指定 --catalog--config,也没有临时目标,则使用默认的可写目录 ~/.mcp-inspector/mcp.json。请参阅配置和标志

选项卡

加速键会避免冲突,而不是始终采用首字母:议(Protocol)使用 p,因此提示(Prompts)使用 m制台(Console)使用 o,因为 c 是全局连接操作的按键。

导航

授权 HTTP 服务器

  1. 选择一个 HTTP 或 SSE 服务器,然后按 c 进行连接。
  2. 如果服务器需要授权,TUI 会自动启动 OAuth,并在浏览器中打开授权 URL。
  3. 当浏览器重定向到 TUI 的回环监听器时,连接会自动完成,无需再次按 c
  4. 使用 认证 标签页查看生成的 OAuth 状态,或清除该状态。
TUI 的回调监听器默认为 http://127.0.0.1:6276/oauth/callback。该端口是有意固定的:预注册的(静态)OAuth 客户端、客户端 ID 元数据文档(CIMD)或企业管理的 IdP 都需要预先知道重定向 URI。注册一次该 URI 后,它就能在不同会话中使用。如果是在远程主机上运行,而你的浏览器位于另一台机器,请转发回调端口,使重定向请求能够到达此监听器;请参阅回调 URL 这样做的代价是,同一时间只能有一个 TUI OAuth 流程占用该端口;第二个并发流程会因 EADDRINUSE 而失败。要覆盖此设置,请传入 --callback-url 或设置 MCP_OAUTH_CALLBACK_URL:为每个实例使用不同的固定端口,或者在授权服务器动态注册重定向 URI 时,使用 http://127.0.0.1:0/oauth/callback,让操作系统分配临时端口。
重定向 URI 必须与注册的内容完全匹配。对于授权服务器而言,localhost127.0.0.1 是不同的 URI。
目录中的每服务器 OAuth 字段(静态客户端 ID/密钥、作用域、企业管理标志)会自动应用。安装范围的设置(CIMD、企业 IdP)来自 ~/.mcp-inspector/storage/client.json,该文件与 Web 客户端的客户端设置对话框写入的文件相同。使用 --client-configMCP_CLIENT_CONFIG_PATH 可指定其他配置文件。 请参阅授权了解完整信息。

认证标签页。它显示的 OAuth 字段与 Web 客户端的连接信息相同,或者报告服务器不需要授权。

要求

该 TUI 需要支持原始模式的真实 TTY。在无头 CI 作业中无法正常运行;请在那里使用 CLI