MCP Test

🚀 MCP服务器测试工具

MCP服务器测试工具是一个专门用于测试其他MCP服务器的工具，采用TypeScript实现，通过标准输入输出（STDIO）模式进行测试。它能够帮助开发者快速、准确地验证MCP服务器的各项功能，提高开发效率和服务器的稳定性。

🚀 快速开始

你可以根据自己的需求选择不同的使用方式，以下为你详细介绍安装和使用方法。

✨ 主要特性

• 连接测试：验证目标MCP服务器的基本连接和初始化情况。
• 能力发现：自动发现并列出目标服务器的所有工具、资源和提示信息。
• 工具调用测试：测试特定工具，确保其正常工作。
• 清晰的测试报告：以结构化、易读的格式展示测试过程和结果。

📦 安装指南

使用npx（推荐）

你可以直接从GitHub运行MCP测试工具，无需安装：

npx github:Peterpan-MU/MCP-Test

本地安装

# 克隆仓库
git clone https://github.com/Peterpan-MU/MCP-Test.git
cd MCP-Test

# 安装依赖
npm install

# 构建项目
npm run build

💻 使用示例

方法一：作为独立的MCP服务器

在你的MCP客户端（如Claude Desktop）中配置此服务器：

选项A：直接从GitHub运行（推荐）

{
  "mcpServers": {
    "mcp-tester": {
      "command": "npx",
      "args": ["-y", "github:Peterpan-MU/MCP-Test"]
    }
  }
}

选项B：使用包名（本地安装后）

# 首先，全局安装或本地链接
npm install -g github:Peterpan-MU/MCP-Test
# 或者
cd MCP-Test && npm link

然后进行配置：

{
  "mcpServers": {
    "mcp-tester": {
      "command": "npx",
      "args": ["mcp-server-tester"]
    }
  }
}

选项C：本地开发

{
  "mcpServers": {
    "mcp-tester": {
      "command": "node",
      "args": ["E:\\MCP Test\\dist\\index.js"]
    }
  }
}

之后，从你的MCP客户端调用测试工具。

方法二：直接运行测试

# 如果已本地安装
npm test

# 或者直接使用npx运行
git clone https://github.com/Peterpan-MU/MCP-Test.git
cd MCP-Test
npm install
npm test

可用工具

1. test_server_connection

测试目标MCP服务器的基本连接能力。 参数：

• command（字符串）：启动命令，例如 "node"、"python"、"uvx"。
• args（数组）：命令参数，例如 ["server.js"]。
• env（对象，可选）：环境变量。

示例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"],
  "env": {
    "API_KEY": "your_key"
  }
}

输出：详细的连接测试报告，包括：

• 连接状态
• 初始化结果
• 测试过程步骤

2. test_server_capabilities

全面测试目标MCP服务器的所有能力。 参数：

• command（字符串）：启动命令。
• args（数组）：命令参数。
• env（对象，可选）：环境变量。

示例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"]
}

输出：完整的能力报告，包括：

• 所有可用工具及其描述列表
• 所有可用资源列表
• 所有可用提示词列表
• 每种能力类型的统计信息

3. test_tool_call

测试在目标MCP服务器上调用特定工具。 参数：

• command（字符串）：启动命令。
• args（数组）：命令参数。
• env（对象，可选）：环境变量。
• test_tool（字符串）：要测试的工具名称。
• tool_arguments（对象，可选）：传递给工具的参数。

示例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"],
  "test_tool": "echo",
  "tool_arguments": {
    "message": "Hello, MCP!"
  }
}

输出：工具调用测试报告，包括：

• 调用是否成功
• 返回的内容
• 是否发生错误

测试示例

示例1：测试一个简单的Node.js MCP服务器

假设你有一个名为 simple_server.js 的MCP服务器：

1. 连接测试：

{
  "command": "node",
  "args": ["/servers/simple_server.js"]
}

2. 能力测试：

{
  "command": "node",
  "args": ["/servers/simple_server.js"]
}

3. 工具调用测试（假设服务器有一个 "get_time" 工具）：

{
  "command": "node",
  "args": ["/servers/simple_server.js"],
  "test_tool": "get_time",
  "tool_arguments": {}
}

示例2：测试一个Python MCP服务器

{
  "command": "python",
  "args": ["/servers/python_server.py"]
}

示例3：测试一个通过uvx安装的MCP服务器

{
  "command": "uvx",
  "args": ["mcp-server-time"]
}

示例测试报告

连接测试报告

============================================================
🧪 MCP Server 连接测试报告
============================================================

📋 测试配置:
  命令: node
  参数: server.js

🔄 测试过程:
  🔌 正在连接到目标MCP Server...
  ✅ 连接初始化成功
  ✅ 基本连接测试通过
  🎉 所有测试步骤完成

✅ 测试结果: 成功
  状态: connected
  消息: 目标服务器成功响应初始化请求

============================================================

能力测试报告

============================================================
🧪 MCP Server 能力测试报告
============================================================

📋 测试配置:
  命令: node
  参数: server.js

🔄 测试过程:
  🔌 正在连接到目标MCP Server...
  ✅ 连接初始化成功
  🔍 正在获取服务器能力...
  📦 发现 3 个工具
  📚 发现 0 个资源
  💬 发现 0 个提示词
  ✅ 能力测试完成
  🎉 所有测试步骤完成

✅ 测试结果: 成功

📦 工具列表 (3):
  1. echo
     描述: Echo back the provided message
  2. add
     描述: Add two numbers together
  3. get_time
     描述: Get current time

📚 资源列表 (0):
  (无资源或不支持)

💬 提示词列表 (0):
  (无提示词或不支持)

============================================================

📚 详细文档

配置文件

参考 test_config_example.json 了解如何配置多个测试服务器和测试场景。

故障排除

问题：MCP错误 -32000：连接关闭

此错误通常意味着MCP客户端无法与服务器建立连接。 解决方案：

1. 尝试使用选项C（本地路径）：

{
  "mcpServers": {
    "mcp-tester": {
      "command": "node",
      "args": ["E:\\MCP Test\\dist\\index.js"]
    }
  }
}

2. 验证npx能否找到该包：

npx -y github:Peterpan-MU/MCP-Test

然后输入一个测试JSON-RPC请求：

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}

3. 检查Node.js版本：

node --version  # 应 >= 18.0.0

4. 尝试清除npx缓存：

npx clear-npx-cache
# 或者
rm -rf ~/.npm/_npx

5. 先进行本地安装：

npm install -g github:Peterpan-MU/MCP-Test

然后在配置中使用 "args": ["mcp-server-tester"]。

问题：连接超时 (-32001)

解决方案：

• 确保安装的是最新版本（dist/ 文件是预构建的，无需编译）。
• 如果使用npx和GitHub URL，请检查网络连接。
• 尝试使用本地安装选项。

问题：工具调用失败

解决方案：

• 首先使用 test_server_capabilities 查看可用工具。
• 检查工具参数是否正确。
• 验证目标服务器的路径和依赖项。

问题：导入错误

解决方案：

cd "E:\MCP Test"
npm install
npm run build

🔧 技术细节

属性	详情
传输模式	STDIO（标准输入/输出）
开发语言	TypeScript
运行时环境	Node.js 18+
MCP SDK 版本	1.0.4+
并发模型	带有Promise的Async/await

项目结构

MCP-Test/
├── src/
│   ├── index.ts              # 主MCP测试服务器
│   ├── tester.ts             # 测试逻辑实现
│   ├── example-server.ts     # 用于测试的示例服务器
│   └── test.ts               # 测试运行脚本
├── dist/                     # 编译后的JavaScript（生成）
├── package.json              # NPM包配置
├── tsconfig.json             # TypeScript配置
├── requirements.txt          # Python依赖项（旧版）
├── README.md                 # 本文件
├── LICENSE                   # MIT许可证
├── .gitignore               # Git忽略规则
└── test_config_example.json # 配置示例

开发

构建项目

npm run build

监听模式（开发）

npm run dev

运行测试

npm test

发布到npm（可选）

要将此包发布到npm以便更方便地访问：

# 登录到npm（仅首次需要）
npm login

# 发布包
npm publish

发布后，用户可以运行：

npx mcp-server-tester

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。

贡献

欢迎提出问题和提交拉取请求！

相关资源

• MCP官方文档
• MCP TypeScript SDK
• MCP服务器列表

变更日志

版本 1.0.0（TypeScript）

• 完全用TypeScript重写。
• 支持npx安装。
• 改进了类型安全性和错误处理。
• 更好地集成到Node.js生态系统中。

版本 0.1.0（Python - 旧版）

• 最初的Python实现。
• 基本的测试功能。
• 支持STDIO模式。