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

# MCP Inspector

> 使用 MCP Inspector 测试和调试 Model Context Protocol 服务器的深入指南

[MCP Inspector](https://github.com/modelcontextprotocol/inspector) 是一个交互式开发者工具，用于测试和调试 MCP 服务器。[调试指南](/docs/tools/debugging)会把 Inspector 作为整体调试工具集的一部分介绍，而本文会更详细地说明 Inspector 的功能和能力。

## 开始使用

### 安装和基本用法

Inspector 可以直接通过 `npx` 运行，不需要提前安装：

```bash theme={null}
npx @modelcontextprotocol/inspector <command>
```

```bash theme={null}
npx @modelcontextprotocol/inspector <command> <arg1> <arg2>
```

#### 检查来自 npm 或 PyPI 的服务器

从 [npm](https://npmjs.com) 或 [PyPI](https://pypi.org) 启动服务器包是一种常见方式。

<Tabs>
  <Tab title="npm package">
    ```bash theme={null}
    npx -y @modelcontextprotocol/inspector npx <package-name> <args>
    # For example
    npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem /Users/username/Desktop
    ```
  </Tab>

  <Tab title="PyPI package">
    ```bash theme={null}
    npx @modelcontextprotocol/inspector uvx <package-name> <args>
    # For example
    npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git
    ```
  </Tab>
</Tabs>

#### 检查本地开发的服务器

如果要检查本地开发的服务器，或以仓库形式下载的服务器，最常见的方式是：

<Tabs>
  <Tab title="TypeScript">
    ```bash theme={null}
    npx @modelcontextprotocol/inspector node path/to/server/index.js args...
    ```
  </Tab>

  <Tab title="Python">
    ```bash theme={null}
    npx @modelcontextprotocol/inspector \
      uv \
      --directory path/to/server \
      run \
      package-name \
      args...
    ```
  </Tab>
</Tabs>

请仔细阅读随附 README，以获取最准确的说明。

## 功能概览

<Frame caption="MCP Inspector 界面">
  <img src="https://mintcdn.com/mcp-af858c62/jSqzMzM_desZfWyn/images/mcp-inspector.png?fit=max&auto=format&n=jSqzMzM_desZfWyn&q=85&s=d985db1dc7568145fdb9ec1fbee6b2e2" width="2888" height="1761" data-path="images/mcp-inspector.png" />
</Frame>

Inspector 提供多种功能，用于与你的 MCP server 交互：

### 服务器连接面板

* 允许选择连接服务器使用的[传输方式](/specification/latest/basic/transports)。
* 对本地服务器，支持自定义命令行参数和环境变量。

### Resources 标签页

* 列出所有可用 resources。
* 显示 resource 元数据（MIME type、description）。
* 支持检查 resource 内容。
* 支持订阅测试。

### Prompts 标签页

* 显示可用 prompt templates。
* 显示 prompt 参数和描述。
* 支持使用自定义参数测试 prompt。
* 预览生成的消息。

### Tools 标签页

* 列出可用 tools。
* 显示 tool schema 和描述。
* 支持使用自定义输入测试 tool。
* 显示 tool 执行结果。

### Notifications 面板

* 展示从服务器记录的所有日志。
* 显示从服务器接收的通知。

## 最佳实践

### 开发工作流

1. 开始开发
   * 使用你的服务器启动 Inspector。
   * 验证基础连通性。
   * 检查能力协商。

2. 迭代测试
   * 修改服务器。
   * 重新构建服务器。
   * 重新连接 Inspector。
   * 测试受影响的功能。
   * 监控消息。

3. 测试边界情况
   * 无效输入。
   * 缺少 prompt 参数。
   * 并发操作。
   * 验证错误处理和错误响应。

## 后续步骤

<CardGroup cols={2}>
  <Card title="Inspector 仓库" icon="github" href="https://github.com/modelcontextprotocol/inspector">
    查看 MCP Inspector 源码
  </Card>

  <Card title="调试指南" icon="bug" href="/docs/tools/debugging">
    了解更完整的调试策略
  </Card>
</CardGroup>