MCP Inspector命令行工具全解析：自动化测试与脚本集成-优快云博客

MCP Inspector命令行工具全解析：自动化测试与脚本集成

【免费下载链接】inspector Visual testing tool for MCP servers 项目地址: https://gitcode.com/gh_mirrors/inspector1/inspector

引言：MCP Inspector CLI解决的核心痛点

你是否在MCP服务器测试中遇到过这些问题？手动执行重复测试步骤效率低下，不同环境间配置难以同步，测试结果缺乏标准化输出？MCP Inspector命令行工具（mcp-inspector-cli）正是为解决这些问题而生。作为MCP（Model Context Protocol）服务器的可视化测试工具，它提供了强大的自动化能力，让开发者能够轻松集成MCP测试流程到CI/CD管道中，实现测试自动化和脚本化。

读完本文，你将获得：

MCP Inspector CLI的完整安装与配置指南
命令行参数与配置文件的深度解析
自动化测试脚本编写的实战案例
高级功能与最佳实践的全面掌握
常见问题的诊断与解决方案

1. MCP Inspector CLI概述

1.1 工具定位与核心价值

MCP Inspector CLI（Command Line Interface）是MCP协议的官方测试工具，它允许开发者通过命令行与MCP服务器进行交互，执行各种测试操作。相较于图形界面，CLI工具更适合集成到自动化测试流程和脚本中，实现持续集成和持续部署。

mermaid

1.2 主要功能特性

MCP Inspector CLI提供了丰富的功能集，包括：

支持多种传输协议（stdio、sse、streamable-http）
环境变量注入与管理
配置文件支持，便于环境隔离
完整的MCP方法调用能力
详细的日志与错误处理
与自动化测试框架的无缝集成

1.3 版本信息与兼容性

当前最新版本：0.16.6

MCP服务器版本	CLI版本	兼容性
0.16.x	0.16.6	✅ 完全兼容
0.15.x	0.16.6	⚠️ 部分兼容，部分新功能不可用
<0.15.0	0.16.6	❌ 不兼容

2. 安装与基础配置

2.1 系统要求

Node.js 14.0.0或更高版本
npm 6.0.0或更高版本
支持的操作系统：Windows 10/11、macOS 10.15+、Linux（Ubuntu 18.04+、CentOS 8+）

2.2 安装方法

# 通过npm安装
npm install -g @modelcontextprotocol/inspector-cli

# 从源码构建安装
git clone https://gitcode.com/gh_mirrors/inspector1/inspector
cd inspector/cli
npm install
npm run build
npm link

验证安装是否成功：

mcp-inspector-cli --version
# 应输出：0.16.6

2.3 基础配置文件

创建基本配置文件mcp-config.json：

{
  "mcpServers": {
    "local-dev": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-everything"],
      "env": {
        "NODE_ENV": "development",
        "LOG_LEVEL": "info"
      }
    },
    "remote-test": {
      "type": "streamable-http",
      "url": "https://test-server.example.com/mcp"
    }
  }
}

3. 命令行参数详解

3.1 核心参数概览

MCP Inspector CLI提供了丰富的命令行参数，可分为以下几类：

mermaid

3.2 模式控制参数

参数	类型	描述	示例
`--cli`	标志	启用纯CLI模式，不启动Web界面	`mcp-inspector-cli --cli`
`--transport`	字符串	指定传输类型，可选值：stdio、sse、http	`mcp-inspector-cli --transport http`

3.3 配置与连接参数

参数	类型	描述	示例
`--config <path>`	字符串	指定配置文件路径	`mcp-inspector-cli --config ./configs/prod.json`
`--server <name>`	字符串	从配置文件中选择服务器配置	`mcp-inspector-cli --config ./config.json --server prod`
`--server-url <url>`	字符串	直接指定服务器URL	`mcp-inspector-cli --server-url https://mcp.example.com`
`--header <header>`	字符串数组	指定HTTP头部	`mcp-inspector-cli --header "Authorization: Bearer token" --header "Content-Type: application/json"`

3.4 环境变量参数

使用-e或--env参数注入环境变量：

# 基本用法
mcp-inspector-cli -e "KEY=value" --cli --method tools/list

# 多个环境变量
mcp-inspector-cli -e "DB_HOST=localhost" -e "DB_PORT=5432" --cli --method db/connect

# 环境变量值包含等号
mcp-inspector-cli -e "JWT_SECRET=abc123=def456" --cli --method auth/verify

3.5 请求参数

参数	类型	描述	示例
`--method <method>`	字符串	指定要调用的MCP方法	`mcp-inspector-cli --cli --method tools/list`
`--uri <uri>`	字符串	指定资源URI（用于资源相关方法）	`mcp-inspector-cli --cli --method resources/read --uri "test://static/resource/1"`
`--prompt-name <name>`	字符串	指定提示名称（用于提示相关方法）	`mcp-inspector-cli --cli --method prompts/get --prompt-name "simple_prompt"`
`--prompt-args <args>`	字符串数组	指定提示参数	`mcp-inspector-cli --cli --method prompts/get --prompt-name "complex_prompt" --prompt-args "temperature=0.7" "style=concise"`
`--log-level <level>`	字符串	设置日志级别	`mcp-inspector-cli --cli --method logging/setLevel --log-level "debug"`

3. 配置文件深度解析

3.1 配置文件结构

MCP Inspector CLI配置文件采用JSON格式，主要包含mcpServers对象，其中每个键表示一个服务器配置：

{
  "mcpServers": {
    "<server-name>": {
      "type": "<transport-type>",
      // 根据传输类型不同，其他配置项有所差异
    }
  }
}

3.2 传输类型配置

3.2.1 stdio传输

{
  "type": "stdio",
  "command": "node",
  "args": ["path/to/server.js", "--option", "value"],
  "env": {
    "ENV_VAR1": "value1",
    "ENV_VAR2": "value2"
  }
}

3.2.2 SSE传输

{
  "type": "sse",
  "url": "http://localhost:3000/sse",
  "note": "开发环境SSE服务器"
}

3.2.3 Streamable HTTP传输

{
  "type": "streamable-http",
  "url": "https://api.example.com/mcp",
  "note": "生产环境HTTP服务器"
}

3.3 配置文件加载优先级

MCP Inspector CLI按以下顺序加载配置文件，后加载的配置会覆盖前面的配置：

内置默认配置
全局配置文件（~/.mcp-inspector/config.json）
当前工作目录配置文件（./mcp-config.json）
通过--config参数指定的配置文件
命令行参数（最高优先级）

3.4 多环境配置策略

推荐的多环境配置目录结构：

project-root/
├── mcp-config/
│   ├── base.json
│   ├── development.json
│   ├── testing.json
│   └── production.json
└── package.json

使用方法：

# 开发环境
mcp-inspector-cli --config ./mcp-config/development.json --server local-dev ...

# 测试环境
mcp-inspector-cli --config ./mcp-config/testing.json --server test-server ...

# 生产环境
mcp-inspector-cli --config ./mcp-config/production.json --server prod-server ...

4. 基础使用指南

4.1 命令结构与语法

MCP Inspector CLI命令的基本结构：

mcp-inspector-cli [全局选项] [服务器命令] [服务器参数]

使用--分隔CLI选项和服务器参数：

mcp-inspector-cli -e "KEY=value" --cli --method tools/list -- --server-arg1 value1 --server-arg2 value2

4.2 启动MCP服务器并连接

# 使用默认配置启动并连接到本地服务器
mcp-inspector-cli

# 使用指定配置文件
mcp-inspector-cli --config ./custom-config.json

# 指定服务器配置
mcp-inspector-cli --config ./config.json --server staging

# 直接指定服务器命令
mcp-inspector-cli npx @modelcontextprotocol/server-everything

4.3 调用MCP方法

4.3.1 基本方法调用

# 列出所有可用工具
mcp-inspector-cli --cli --method tools/list

# 获取特定工具信息
mcp-inspector-cli --cli --method tools/get --tool-name "file_system"

# 调用工具
mcp-inspector-cli --cli --method tools/call --tool-name "echo" --tool-arg "message=Hello, MCP!"

4.3.2 资源操作

# 列出资源
mcp-inspector-cli --cli --method resources/list

# 读取资源
mcp-inspector-cli --cli --method resources/read --uri "test://static/resource/1"

# 创建资源
mcp-inspector-cli --cli --method resources/create --uri "test://dynamic/resource" --resource-data '{"key": "value"}'

4.3.3 提示操作

# 列出所有提示
mcp-inspector-cli --cli --method prompts/list

# 获取特定提示
mcp-inspector-cli --cli --method prompts/get --prompt-name "code_generation"

# 调用提示
mcp-inspector-cli --cli --method prompts/invoke --prompt-name "code_generation" --prompt-args "language=javascript" "task=sort_array"

4.4 输出格式与解析

MCP Inspector CLI默认输出JSON格式结果，便于自动化解析：

mcp-inspector-cli --cli --method tools/list > tools.json

解析输出的示例Python脚本：

import json

with open('tools.json', 'r') as f:
    result = json.load(f)

if result['status'] == 'success':
    print(f"Found {len(result['data'])} tools:")
    for tool in result['data']:
        print(f"- {tool['name']}: {tool['description']}")
else:
    print(f"Error: {result['error']['message']}")

5. 自动化测试与脚本集成

5.1 测试脚本基础结构

一个典型的MCP Inspector CLI测试脚本：

#!/bin/bash

# 测试工具列表方法
echo "Testing tools/list method..."
result=$(mcp-inspector-cli --cli --method tools/list)
status=$(echo "$result" | jq -r '.status')

if [ "$status" != "success" ]; then
    echo "Test failed: $(echo "$result" | jq -r '.error.message')"
    exit 1
fi

tool_count=$(echo "$result" | jq '.data | length')
echo "Found $tool_count tools. Test passed."

exit 0

5.2 与CI/CD系统集成

GitHub Actions集成

# .github/workflows/mcp-test.yml
name: MCP Server Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    
    steps:
      - uses: actions/checkout@v3
      
      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '16'
          
      - name: Install dependencies
        run: npm install -g @modelcontextprotocol/inspector-cli
        
      - name: Run MCP tests
        run: |
          # 启动测试服务器（后台运行）
          mcp-inspector-cli npx @modelcontextprotocol/server-everything &
          SERVER_PID=$!
          
          # 等待服务器启动
          sleep 5
          
          # 运行测试套件
          ./scripts/run-mcp-tests.sh
          
          # 停止服务器
          kill $SERVER_PID

GitLab CI集成

# .gitlab-ci.yml
mcp-test:
  image: node:16
  stage: test
  before_script:
    - npm install -g @modelcontextprotocol/inspector-cli
  script:
    - mcp-inspector-cli --cli --method tools/list
    - mcp-inspector-cli --cli --method prompts/list
    - mcp-inspector-cli --cli --method resources/list
  after_script:
    - echo "MCP tests completed"

5.3 批量测试脚本示例

以下是一个完整的MCP服务器功能测试脚本：

#!/bin/bash
set -euo pipefail

# 测试结果跟踪
PASSED=0
FAILED=0
TOTAL=0

# 测试函数
run_test() {
    local name="$1"
    local command="$2"
    local expected_exit_code="${3:-0}"
    
    echo "=== Testing: $name ==="
    ((TOTAL++))
    
    # 执行测试命令
    if output=$(eval "$command" 2>&1); then
        exit_code=0
    else
        exit_code=$?
    fi
    
    # 检查结果
    if [ "$exit_code" -eq "$expected_exit_code" ]; then
        echo "✅ PASSED: $name"
        ((PASSED++))
        return 0
    else
        echo "❌ FAILED: $name"
        echo "Command: $command"
        echo "Exit code: $exit_code (expected: $expected_exit_code)"
        echo "Output:"
        echo "$output"
        ((FAILED++))
        return 1
    fi
}

# 启动测试服务器
echo "Starting test MCP server..."
mcp-inspector-cli npx @modelcontextprotocol/server-everything &
SERVER_PID=$!

# 等待服务器启动
sleep 5

# 运行测试套件
run_test "List tools" "mcp-inspector-cli --cli --method tools/list"
run_test "List prompts" "mcp-inspector-cli --cli --method prompts/list"
run_test "List resources" "mcp-inspector-cli --cli --method resources/list"
run_test "Get specific tool" "mcp-inspector-cli --cli --method tools/get --tool-name 'echo'"
run_test "Get non-existent tool (should fail)" "mcp-inspector-cli --cli --method tools/get --tool-name 'nonexistent'" 1
run_test "Call echo tool" "mcp-inspector-cli --cli --method tools/call --tool-name 'echo' --tool-arg 'message=Hello'"
run_test "Read test resource" "mcp-inspector-cli --cli --method resources/read --uri 'test://static/resource/1'"
run_test "Read non-existent resource (should fail)" "mcp-inspector-cli --cli --method resources/read --uri 'test://static/nonexistent'" 1

# 停止测试服务器
kill $SERVER_PID

# 输出测试总结
echo "========================================"
echo "Test Summary:"
echo "Total: $TOTAL, Passed: $PASSED, Failed: $FAILED"
echo "========================================"

if [ "$FAILED" -gt 0 ]; then
    echo "❌ Some tests failed"
    exit 1
else
    echo "✅ All tests passed"
    exit 0
fi

6. 高级功能与最佳实践

6.1 传输协议选择指南

MCP Inspector CLI支持多种传输协议，选择合适的协议对性能和兼容性至关重要：

传输类型	适用场景	优点	缺点
stdio	本地开发、集成测试	无需网络配置、低延迟	无法远程访问、不支持并发连接
sse	实时通知、事件驱动场景	服务器推送能力、持久连接	不适合大量数据传输
streamable-http	生产环境、跨网络访问	标准HTTP协议、防火墙友好、可靠性高	相对较高的延迟

mermaid

6.2 环境变量管理策略

在自动化测试中，有效的环境变量管理至关重要：

环境变量分层：
- 基础环境变量（通用配置）
- 环境特定变量（开发/测试/生产）
- 敏感变量（密钥、凭证）

敏感信息处理：

# 从安全存储获取敏感变量
export API_KEY=$(vault read -field=key secret/mcp/api)

# 使用敏感变量调用MCP方法
mcp-inspector-cli -e "API_KEY=$API_KEY" --cli --method auth/authenticate

环境变量文件：创建.env.development、.env.test、.env.production文件，使用环境变量加载工具导入：
```
# 使用dotenv加载环境变量
npx dotenv -e .env.test -- mcp-inspector-cli --cli --method db/connect
```

6.3 日志与调试技巧

6.3.1 日志级别控制

# 设置全局日志级别
mcp-inspector-cli -e "LOG_LEVEL=debug" --cli --method tools/list

# 设置特定模块日志级别
mcp-inspector-cli -e "LOG_LEVEL=info" -e "LOG_LEVEL_transport=debug" --cli --method tools/list

6.3.2 详细调试输出

# 启用详细调试模式
mcp-inspector-cli --cli --method tools/call --tool-name "echo" --tool-arg "message=test" --debug

# 将日志输出到文件
mcp-inspector-cli --cli --method tools/list > mcp-debug.log 2>&1

6.3.3 网络请求调试

# 使用curl验证MCP HTTP端点
curl -v http://localhost:3000/mcp -H "Content-Type: application/json" -d '{"method": "tools/list"}'

# 使用CLI测试HTTP传输
mcp-inspector-cli http://localhost:3000/mcp --transport http --cli --method tools/list

6.4 性能优化建议

连接复用：在长时间运行的测试脚本中，保持单一连接而非反复创建新连接。
批处理操作：将多个独立的MCP调用合并为批处理操作，减少往返开销。

并行测试：使用并行测试框架（如GNU Parallel）同时运行多个独立测试：

# 并行运行测试用例
parallel -j 4 ::: \
  "mcp-inspector-cli --cli --method tools/list" \
  "mcp-inspector-cli --cli --method prompts/list" \
  "mcp-inspector-cli --cli --method resources/list" \
  "mcp-inspector-cli --cli --method roots/list"

资源缓存：对于重复的资源请求，考虑使用本地缓存减少服务器负载：

# 使用缓存代理调用资源读取方法
mcp-inspector-cli --cli --method resources/read --uri "test://large/resource" --cache-dir ./cache

7. 常见问题与故障排除

7.1 连接问题诊断

7.1.1 无法连接到服务器

# 检查服务器是否运行
curl http://localhost:3000/health

# 检查端口占用情况
netstat -tulpn | grep 3000  # Linux
# 或
lsof -i :3000  # macOS

# 验证防火墙设置
ufw status | grep 3000  # Linux

7.1.2 传输协议不匹配

错误表现：连接成功但无法调用方法或接收响应。

排查步骤：

确认服务器支持的传输协议
检查CLI使用的传输协议
验证URL格式是否正确（特别是对于HTTP/SSE）

# 显式指定传输协议
mcp-inspector-cli --transport sse http://localhost:3000/sse --cli --method tools/list

7.2 认证与授权问题

7.2.1 权限被拒绝错误

# 检查认证凭据
mcp-inspector-cli -e "AUTH_TOKEN=valid_token" --cli --method auth/verify

# 检查用户权限
mcp-inspector-cli --cli --method auth/check-permissions --permission "tools:execute"

7.2.2 OAuth流程问题

# 启用OAuth调试模式
mcp-inspector-cli --cli --oauth-debug --method auth/oauth/authorize

7.3 方法调用错误处理

7.3.1 常见错误代码解析

错误代码	含义	可能原因	解决方案
400	无效请求	请求参数格式错误	检查参数格式和类型
404	方法未找到	方法名称错误或服务器不支持	验证方法名称和服务器版本
403	权限不足	用户没有执行该方法的权限	检查认证凭据和权限设置
500	服务器内部错误	服务器代码异常	查看服务器日志，报告问题
503	服务不可用	服务器过载或维护中	稍后重试，检查服务器状态

7.3.2 调试方法调用错误

# 启用详细错误输出
mcp-inspector-cli --cli --method tools/call --tool-name "problematic_tool" --debug

# 捕获完整请求/响应
mcp-inspector-cli --cli --method tools/call --tool-name "problematic_tool" --log-request-response

7.4 配置文件常见问题

7.4.1 JSON格式错误

# 验证配置文件JSON格式
jsonlint mcp-config.json

# 修复常见JSON问题
sed -i 's/,$//' mcp-config.json  # 移除末尾逗号

7.4.2 配置文件路径问题

# 检查配置文件是否存在且可访问
ls -l "$(which mcp-inspector-cli)"
ls -l ~/.mcp-inspector/config.json

# 验证配置文件权限
chmod 600 ~/.mcp-inspector/config.json

8. 高级应用场景

8.1 MCP服务器性能测试

以下是一个使用MCP Inspector CLI进行性能测试的脚本：

#!/bin/bash
set -euo pipefail

# 性能测试配置
CONCURRENT_REQUESTS=(1 5 10 20 50)
TEST_DURATION=30
METHOD="tools/call"
TOOL_NAME="echo"
TOOL_ARG="message=performance_test"

# 结果文件
RESULT_FILE="performance-results.csv"

# 写入CSV头
echo "timestamp,concurrent_requests,throughput,avg_latency,p95_latency,error_rate" > "$RESULT_FILE"

# 启动测试服务器
echo "Starting MCP server for performance testing..."
mcp-inspector-cli npx @modelcontextprotocol/server-everything &
SERVER_PID=$!
sleep 5  # 等待服务器启动

# 运行不同并发级别的测试
for concurrency in "${CONCURRENT_REQUESTS[@]}"; do
    echo "Running performance test with $concurrency concurrent requests..."
    
    # 使用wrk进行HTTP性能测试
    result=$(wrk -t"$concurrency" -c"$concurrency" -d"${TEST_DURATION}s" \
        -s ./scripts/mcp-wrk.lua \
        -H "Content-Type: application/json" \
        "http://localhost:3001/mcp" \
        -- -method "$METHOD" -tool-name "$TOOL_NAME" -tool-arg "$TOOL_ARG")
    
    # 解析结果并写入CSV
    timestamp=$(date +%Y-%m-%dT%H:%M:%S)
    throughput=$(echo "$result" | grep "Requests/sec" | awk '{print $2}')
    avg_latency=$(echo "$result" | grep "Avg" | awk '{print $2}')
    p95_latency=$(echo "$result" | grep "95%" | awk '{print $3}')
    error_rate="0.00"  # 简化示例，实际应从结果中提取
    
    echo "$timestamp,$concurrency,$throughput,$avg_latency,$p95_latency,$error_rate" >> "$RESULT_FILE"
    
    echo "Completed test with $concurrency concurrent requests. Results appended to $RESULT_FILE"
    sleep 10  # 让服务器恢复
done

# 停止服务器
kill $SERVER_PID

echo "Performance testing completed. Results saved to $RESULT_FILE"

8.2 与测试框架集成

8.2.1 与Jest集成

// mcp.test.js
const { execSync } = require('child_process');

describe('MCP Server Tests', () => {
  let serverProcess;
  
  // 启动服务器
  beforeAll(() => {
    serverProcess = require('child_process').spawn(
      'mcp-inspector-cli',
      ['npx', '@modelcontextprotocol/server-everything'],
      { detached: true }
    );
    
    // 等待服务器启动
    return new Promise(resolve => setTimeout(resolve, 5000));
  });
  
  // 停止服务器
  afterAll(() => {
    process.kill(-serverProcess.pid);
  });
  
  // 测试工具列表方法
  test('should list available tools', () => {
    const output = execSync('mcp-inspector-cli --cli --method tools/list');
    const result = JSON.parse(output.toString());
    
    expect(result.status).toBe('success');
    expect(Array.isArray(result.data)).toBe(true);
    expect(result.data.length).toBeGreaterThan(0);
  });
  
  // 测试资源读取方法
  test('should read test resource', () => {
    const output = execSync(
      'mcp-inspector-cli --cli --method resources/read --uri "test://static/resource/1"'
    );
    const result = JSON.parse(output.toString());
    
    expect(result.status).toBe('success');
    expect(result.data).toHaveProperty('id', '1');
  });
});

8.2.2 与PyTest集成

# test_mcp_server.py
import subprocess
import time
import json
import pytest

@pytest.fixture(scope="module")
def mcp_server():
    # 启动MCP服务器
    server = subprocess.Popen(
        ["mcp-inspector-cli", "npx", "@modelcontextprotocol/server-everything"],
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE
    )
    
    # 等待服务器启动
    time.sleep(5)
    
    # 提供服务器进程给测试
    yield server
    
    # 测试完成后停止服务器
    server.terminate()
    server.wait()

def run_mcp_command(command):
    """执行MCP CLI命令并返回解析后的结果"""
    result = subprocess.run(
        command,
        shell=True,
        capture_output=True,
        text=True
    )
    
    try:
        return json.loads(result.stdout)
    except json.JSONDecodeError:
        return {
            "status": "error",
            "error": {
                "message": "Failed to parse output",
                "stdout": result.stdout,
                "stderr": result.stderr
            }
        }

def test_tools_list(mcp_server):
    """测试工具列表方法"""
    result = run_mcp_command("mcp-inspector-cli --cli --method tools/list")
    assert result["status"] == "success"
    assert isinstance(result["data"], list)
    assert len(result["data"]) > 0

def test_prompts_get(mcp_server):
    """测试获取提示方法"""
    result = run_mcp_command(
        'mcp-inspector-cli --cli --method prompts/get --prompt-name "simple_prompt"'
    )
    assert result["status"] == "success"
    assert result["data"]["name"] == "simple_prompt"

9. 总结与展望

9.1 核心功能回顾

MCP Inspector CLI提供了强大的命令行界面，用于与MCP服务器交互和自动化测试。其核心优势包括：

多传输协议支持，适应不同部署场景
灵活的配置系统，便于环境管理
完整的MCP方法调用能力
丰富的自动化测试与集成选项
强大的调试与日志功能

9.2 最佳实践总结

环境隔离：使用配置文件和环境变量实现不同环境的隔离
自动化优先：将所有测试流程自动化，集成到CI/CD管道
安全处理：敏感信息使用环境变量或安全存储，避免硬编码
详细日志：在调试和问题诊断时使用详细日志
渐进式测试：从基础功能测试开始，逐步构建复杂场景测试

9.3 未来发展方向

MCP Inspector CLI的未来发展将聚焦于：

更丰富的测试断言库
性能测试与基准测试工具集成
可视化测试报告生成
与更多第三方工具的集成
AI辅助的测试用例生成与优化

9.4 资源与学习路径

官方资源

MCP协议文档：https://modelcontextprotocol.io/docs
GitHub仓库：https://gitcode.com/gh_mirrors/inspector1/inspector
npm包信息：https://www.npmjs.com/package/@modelcontextprotocol/inspector-cli

学习路径

入门：
- 安装CLI工具
- 熟悉基本命令
- 尝试调用简单MCP方法
进阶：
- 创建自定义配置文件
- 编写简单测试脚本
- 集成到开发流程
专家：
- 构建完整自动化测试套件
- 性能测试与优化
- 多环境部署与测试策略

10. 附录：命令参考速查表

基础命令

命令	描述
`mcp-inspector-cli --version`	显示版本信息
`mcp-inspector-cli --help`	显示帮助信息
`mcp-inspector-cli`	启动默认配置的MCP服务器和Web界面
`mcp-inspector-cli --cli`	启动CLI模式

服务器管理

命令	描述
`mcp-inspector-cli <server-command>`	启动指定的服务器命令
`mcp-inspector-cli --config <path>`	使用指定配置文件
`mcp-inspector-cli --server <name>`	使用配置文件中的指定服务器
`mcp-inspector-cli --transport <type>`	指定传输协议类型

方法调用

命令	描述
`mcp-inspector-cli --cli --method <method>`	调用指定MCP方法
`mcp-inspector-cli --cli --method tools/list`	列出所有工具
`mcp-inspector-cli --cli --method prompts/list`	列出所有提示
`mcp-inspector-cli --cli --method resources/list`	列出所有资源

调试与日志

命令	描述
`mcp-inspector-cli -e "LOG_LEVEL=debug" --cli ...`	设置调试级日志
`mcp-inspector-cli --cli --method <method> --debug`	启用方法调用调试
`mcp-inspector-cli --cli ... > output.log 2>&1`	将输出重定向到文件

【免费下载链接】inspector Visual testing tool for MCP servers 项目地址: https://gitcode.com/gh_mirrors/inspector1/inspector

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考