MCP Inspector22完全指南：如何高效测试与调试MCP服务器连接

【免费下载链接】inspector Testing and Debugging MCPs 项目地址: https://gitcode.com/gh_mirrors/inspector22/inspector

MCP Inspector22是一款功能强大的MCP服务器测试与调试工具，专为开发者打造，提供直观的界面和丰富的功能，帮助您轻松诊断和解决MCP服务器连接问题。本文将详细介绍如何使用这款工具来提升您的开发效率。

🌟 为什么选择MCP Inspector22？

MCP Inspector22作为MCP服务器的专业调试工具，具备多项核心优势：

• 多协议支持：全面支持STDIO、SSE和Streamable HTTP三种协议，可连接任何MCP服务器
• 工具执行功能：直接运行服务器工具并实时输入参数，轻松调试错误
• LLM工具交互：与真实LLM进行交互测试，验证服务器响应
• 增强型调试工具：提供丰富的日志功能，简化服务器调试流程
• 实用功能提升：支持请求保存、多服务器连接和连接状态保存

MCP Inspector22界面展示

🚀 快速开始：5分钟安装指南

一键启动（推荐）

最简单的安装方式是使用npx直接运行：

npx @mcpjam/inspector@latest

工具将自动在浏览器中启动，默认地址为http://localhost:6274。

从源码安装

如果您需要进行本地开发或自定义：

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/inspector22/inspector
cd inspector

# 安装依赖
npm install

# 启动开发服务器
npm run dev

⚙️ 系统要求

使用MCP Inspector22前，请确保您的系统满足以下要求：

• Node.js：^22.7.5或更高版本
• npm：^10.0.0或更高版本（通常随Node.js一起安装）

💻 基本使用方法

启动与连接服务器

1. 使用上述安装方法启动Inspector22
2. 在界面左侧的"Transport Type"选择连接协议
3. 输入服务器命令和参数
4. 点击"Connect"按钮建立连接

常用命令示例

基本启动

# 使用默认设置启动inspector
npx @mcpjam/inspector

连接本地服务器

# 连接到构建好的本地服务器
npx @mcpjam/inspector node build/index.js

带参数连接

# 传递自定义参数给服务器
npx @mcpjam/inspector node server.js --port 3000 --debug

🛠️ 高级功能详解

使用配置文件

创建自定义配置文件可以保存服务器设置，方便重复使用：

# 使用配置文件启动
npx @mcpjam/inspector --config ./my-config.json

示例配置文件（sample-config.json）：

{
  "mcpServers": {
    "my-awesome-server": {
      "command": "node",
      "args": ["build/index.js"],
      "env": {
        "API_KEY": "your-api-key",
        "DEBUG": "true"
      }
    },
    "python-server": {
      "command": "python",
      "args": ["-m", "my_mcp_server"],
      "env": {
        "PYTHONPATH": "./src"
      }
    }
  }
}

工具执行功能

在界面的"Tools"标签页中，您可以：

1. 浏览可用工具列表
2. 选择工具并输入参数
3. 点击"Run Tool"执行
4. 在右侧查看工具执行结果

调试与日志

MCP Inspector22提供了增强的日志功能：

• 在界面底部调整日志级别（如debug、info、warn）
• 查看工具调用历史和服务器通知
• 检查环境变量和配置信息

📁 项目结构

MCP Inspector22采用现代化的monorepo架构，主要包含三个组件：

📦 inspector
├── 🖥️  client/     # React + TypeScript前端
├── 🔧  server/     # Express.js后端，支持WebSocket
└── 🚀  cli/        # 命令行界面

前端代码位于client/src/目录，后端代码位于server/src/目录，CLI工具代码位于cli/src/目录。

📝 总结

MCP Inspector22是测试和调试MCP服务器的终极工具，通过直观的界面和强大的功能，帮助开发者快速诊断和解决服务器连接问题。无论您是MCP新手还是经验丰富的开发者，这款工具都能显著提升您的开发效率。

立即尝试MCP Inspector22，体验高效的MCP服务器调试流程！

【免费下载链接】inspector Testing and Debugging MCPs 项目地址: https://gitcode.com/gh_mirrors/inspector22/inspector