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

# 检查器

> 用于测试和调试 Model Context Protocol 服务器的 MCP 检查器深入指南

[MCP 检查器](https://github.com/modelcontextprotocol/inspector)是一个用于测试和调试 MCP 服务器的交互式开发者工具。虽然[调试指南](/docs/tools/debugging)将检查器作为整体调试工具包的一部分进行介绍，但本文档详细探讨了检查器的功能和特性。

## 入门

### 安装和基本使用

检查器可以直接通过 `npx` 运行，无需安装:

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

```bash theme={null}
npx @modelcontextprotocol/inspector <命令> <参数1> <参数2>
```

#### 检查来自 NPM 或 PyPi 的服务器

从 [NPM](https://npmjs.com) 或 [PyPi](https://pypi.com) 启动服务器包的常见方法。

<Tabs>
  <Tab title="NPM 包">
    ```bash theme={null}
    npx -y @modelcontextprotocol/inspector npx <包名> <参数>
    # 例如
    npx -y @modelcontextprotocol/inspector npx server-postgres postgres://127.0.0.1/testdb
    ```
  </Tab>

  <Tab title="PyPi 包">
    ```bash theme={null}
    npx @modelcontextprotocol/inspector uvx <包名> <参数>
    # 例如
    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 检查器界面">
  <img src="https://mintcdn.com/magent/4wuiZ9JPF_Ha0vV2/images/mcp-inspector.png?fit=max&auto=format&n=4wuiZ9JPF_Ha0vV2&q=85&s=8c69b8d1d7f0d458e73c8a7d192f5665" width="2888" height="1761" data-path="images/mcp-inspector.png" />
</Frame>

检查器提供了几个用于与 MCP 服务器交互的功能:

### 服务器连接面板

* 允许选择用于连接服务器的[传输](/docs/concepts/transports)
* 对于本地服务器，支持自定义命令行参数和环境

### 资源标签页

* 列出所有可用资源
* 显示资源元数据(MIME 类型、描述)
* 允许检查资源内容
* 支持订阅测试

### 提示词标签页

* 显示可用的提示词模板
* 显示提示词参数和描述
* 启用带自定义参数的提示词测试
* 预览生成的消息

### 工具标签页

* 列出可用工具
* 显示工具模式和描述
* 启用带自定义输入的工具测试
* 显示工具执行结果

### 通知面板

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

## 最佳实践

### 开发工作流

1. 开始开发
   * 使用检查器启动服务器
   * 验证基本连接
   * 检查能力协商

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

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

## 下一步

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

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