TUI 客户端
社区译文；来源： MCP 80041ab0
TUI 是 Inspector 的终端界面，具备与 web 客户端相同的工具、资源和 prompt 交互式探索能力。适用于通过 SSH 访问的远程主机、受限环境，或你更愿意待在终端里的场合。
npx @modelcontextprotocol/inspector --tui node build/index.js # with an ad-hoc stdio server
选择服务器
与 CLI 不同，TUI 没有用于挑选单个条目的 --server <name> flag：它从 catalog 或配置文件读取服务器，加载其中的每一个，然后让你在屏幕列表中选择：
mcp-inspector --tui --catalog mcp.json # writable catalog, seeded empty if missing
mcp-inspector --tui --config mcp.json # read-only session, errors if absent既没有 --catalog 也没有 --config，且没有临时目标
时，它使用默认可写 catalog ~/.mcp-inspector/mcp.json。参见配置与 flag
。
TUI 还接受共享的服务器选择 flag
（--server-url、--transport、--header、-e、--cwd），以及用于临时服务器的 --protocol-era，还有 OAuth 客户端 flag
（--client-id、--client-secret、--client-metadata-url、--client-config、--callback-url）。
标签页
| 标签页 | 按键 | 显示内容 |
|---|---|---|
| Info | i | 服务器配置、名称、版本与 instructions，以及客户端声明的 roots（按 e 编辑它们）。 |
| Auth | a | 所选 HTTP 或 SSE 服务器的 OAuth 状态，以及 Clear OAuth State 操作（s），它也会断开活动连接。 |
| Resources | r | 浏览并读取资源。 |
| Subscriptions | u | 订阅和取消订阅资源（适用于支持资源订阅的服务器）。 |
| Prompts | m | 列出 prompt 并用参数渲染它们。 |
| Skills | k | 列出服务器的 skills 并验证其摘要与 frontmatter（适用于声明 skills 扩展的服务器）。 |
| Tools | t | 查看工具并以类表单输入执行它们。 |
| Tasks | s | 列出任务、获取其结果、取消它们并清除已完成的任务（适用于支持 Tasks 的服务器）。 |
| Protocol | p | JSON-RPC 请求/响应/通知历史。 |
| Network | n | SSE 与 Streamable HTTP 服务器的 HTTP 流量。 |
| Console | o | 已连接 stdio 服务器进程的 stderr。 |
这些快捷键选择的是避免冲突而非总取首字母：Protocol 取 p，因此 Prompts 取 m；Console 取 o，因为 c 是全局的 Connect 操作。Tasks 取 s，这是它唯一空闲的字母，因此 Subscriptions 取 u，Skills 取 k。
Auth、Network 和 Console 只在适用的传输方式下出现；Subscriptions、Skills 和 Tasks 只在已连接的服务器支持它们之后出现。
导航
| 按键 | 操作 |
|---|---|
Tab / Shift+Tab | 移动焦点：服务器列表 → 标签栏 → 列表 → 详情 |
Left / Right 方向键（标签栏获焦时），或某个标签页的字母 | 切换标签页 |
Up / Down 方向键 | 选择服务器、在列表中移动，或滚动详情，取决于哪个窗格获焦 |
Enter | 选择条目、执行工具，或获取资源 |
c | 连接到所选服务器 |
d | 断开 |
/ | 过滤当前列表（Enter 保留过滤，Esc 清除） |
+ | 全屏打开详情窗格 |
y / w | 在详情对话框中：复制该值，或保存到文件（w 也可保存工具结果） |
? | 显示或隐藏键位帮助 |
Esc 或 Ctrl+C | 退出（Esc 会先关闭已打开的对话框） |
没有对话框打开时按 ?，可查看完整键位参考，包括当前活动标签页特有的按键。
授权 HTTP 服务器
- 选择一个 HTTP 或 SSE 服务器并按
c连接。 - 如果服务器要求授权，TUI 会自动启动 OAuth 并在浏览器中打开授权 URL。
- 当浏览器重定向落到 TUI 的 loopback 监听器上时，连接会自行完成，无需再次按
c。 - 使用 Auth 标签页查看生成的 OAuth 状态，或清除它。
TUI 的回调监听器默认为 http://127.0.0.1:6276/oauth/callback。该端口是故意固定的：预注册（静态）OAuth 客户端、Client ID Metadata Document (CIMD)
或企业托管 IdP 都需要一个事先已知的重定向 URI。注册该 URI 一次，即可跨会话使用。在你的浏览器位于另一台机器的远程主机上时，请转发该回调端口，使重定向能到达这个监听器；参见回调 URL
。
代价是同一时间只能有一个 TUI OAuth 流程占用该端口；第二个并发流程会以 EADDRINUSE 失败。要覆盖它，请传入 --callback-url 或设置 MCP_OAUTH_CALLBACK_URL：为每个实例使用不同的固定端口，或在你的授权服务器动态注册重定向 URI 时使用 http://127.0.0.1:0/oauth/callback 让操作系统分配临时端口。
localhost 和 127.0.0.1 是不同的 URI。catalog 中的逐服务器 OAuth 字段（静态 client id/secret、scopes、企业托管标志）会被自动应用。安装级设置（CIMD、企业 IdP）来自 ~/.mcp-inspector/storage/client.json，即 web 客户端 Client Settings 对话框写入的同一个文件。用 --client-config 或 MCP_CLIENT_CONFIG_PATH 指向另一个文件。
完整图景参见授权 。
要求
TUI 需要一个支持 raw 模式的真实 TTY。它在无头 CI 任务中无法有效运行；那里请使用 CLI 。