> ## Documentation Index
> Fetch the complete documentation index at: https://mcp.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TUI 客户端

> 终端 MCP Inspector：导航、选项卡和键盘参考

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

```bash theme={null}
npx @modelcontextprotocol/inspector --tui node build/index.js   # 使用临时 stdio 服务器
```

<Frame caption="TUI 已连接到服务器，当前位于工具选项卡，显示某个工具的输入架构。">
  <img src="https://mintcdn.com/mcp-zhcndoc/g9OY95jIBkKJGM1n/images/inspector/tui-tools.png?fit=max&auto=format&n=g9OY95jIBkKJGM1n&q=85&s=fd0d4641cbe24e1eb05258d880f8d251" width="2986" height="1832" data-path="images/inspector/tui-tools.png" />
</Frame>

## 选择服务器

与 CLI 不同，TUI 没有用于选择单个条目的 `--server <name>` 标志；它会从目录或配置文件中读取服务器，加载其中的每台服务器，并让你从屏幕上的列表中进行选择：

```bash theme={null}
mcp-inspector --tui --catalog mcp.json   # 可写目录；如果缺失则初始化为空（与 Web 客户端不同）
mcp-inspector --tui --config mcp.json    # 只读会话；如果文件不存在则报错
```

如果既未指定 `--catalog` 或 `--config`，也没有[临时目标](/docs/draft/tools/inspector/configuration#ad-hoc-targets)，则使用默认的可写目录 `~/.mcp-inspector/mcp.json`。请参阅[配置和标志](/docs/draft/tools/inspector/configuration)。

## 选项卡

| 选项卡     | 按键  | 显示内容                                                                   |
| ------- | --- | ---------------------------------------------------------------------- |
| **信息**  | `i` | 服务器信息、功能以及协商的协议详细信息。                                                   |
| **认证**  | `a` | 所选服务器的 OAuth 状态，以及**清除 OAuth 状态**操作。                                   |
| **资源**  | `r` | 浏览和读取资源。                                                               |
| **提示**  | `m` | 列出提示并使用参数渲染它们。                                                         |
| **工具**  | `t` | 查看工具，并使用类似表单的输入执行工具。                                                   |
| **协议**  | `p` | JSON-RPC 请求/响应/通知历史记录。                                                 |
| **网络**  | `n` | SSE 和 [可流式 HTTP](/specification/latest/basic/transports) 服务器的 HTTP 流量。 |
| **控制台** | `o` | 已连接 stdio 服务器进程的 `stderr`。                                             |

加速键会避免冲突，而不是始终采用首字母：**协**议（**P**rotocol）使用 `p`，因此提示（Pro**m**pts）使用 `m`；**控**制台（**C**onsole）使用 `o`，因为 `c` 是全局连接操作的按键。

## 导航

| 按键                          | 操作             |
| --------------------------- | -------------- |
| `Left` / `Right` 箭头键或 `Tab` | 切换标签页          |
| `Up` / `Down` 箭头键           | 在当前列表中移动       |
| `Enter`                     | 选择项目、执行工具或获取资源 |
| `c`                         | 连接到选中的服务器      |
| `d`                         | 断开连接           |
| `Esc` 或 `Ctrl+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）](/specification/latest/basic/authorization/client-registration#client-id-metadata-documents)或企业管理的 IdP 都需要预先知道重定向 URI。注册一次该 URI 后，它就能在不同会话中使用。如果是在远程主机上运行，而你的浏览器位于另一台机器，请转发回调端口，使重定向请求能够到达此监听器；请参阅[回调 URL](/docs/draft/tools/inspector/authorization#callback-urls)。

这样做的代价是，同一时间只能有一个 TUI OAuth 流程占用该端口；第二个并发流程会因 `EADDRINUSE` 而失败。要覆盖此设置，请传入 `--callback-url` 或设置 `MCP_OAUTH_CALLBACK_URL`：为每个实例使用不同的固定端口，或者在授权服务器动态注册重定向 URI 时，使用 `http://127.0.0.1:0/oauth/callback`，让操作系统分配临时端口。

<Warning>
  重定向 URI 必须与注册的内容**完全匹配**。对于授权服务器而言，`localhost` 和
  `127.0.0.1` 是不同的 URI。
</Warning>

目录中的每服务器 OAuth 字段（静态客户端 ID/密钥、作用域、企业管理标志）会自动应用。安装范围的设置（CIMD、企业 IdP）来自 `~/.mcp-inspector/storage/client.json`，该文件与 Web 客户端的**客户端设置**对话框写入的文件相同。使用 `--client-config` 或 `MCP_CLIENT_CONFIG_PATH` 可指定其他配置文件。

请参阅[授权](/docs/draft/tools/inspector/authorization)了解完整信息。

<Frame caption="认证标签页。它显示的 OAuth 字段与 Web 客户端的连接信息相同，或者报告服务器不需要授权。">
  <img src="https://mintcdn.com/mcp-zhcndoc/g9OY95jIBkKJGM1n/images/inspector/tui-auth.png?fit=max&auto=format&n=g9OY95jIBkKJGM1n&q=85&s=28e1c710ce91848e095782dc2d887caa" width="2986" height="1832" data-path="images/inspector/tui-auth.png" />
</Frame>

## 要求

该 TUI 需要支持原始模式的真实 TTY。在无头 CI 作业中无法正常运行；请在那里使用 [CLI](/docs/draft/tools/inspector/cli)。