MCP Server Tester Po4

MCP服务器测试工具是一个配置驱动的测试解决方案，用于验证、基准测试和确保与AI模型集成的MCP服务器的可靠性。它支持自动发现工具、生成智能测试用例、执行验证并生成详细报告。

开发者工具人工智能聊天机器人 #AI测试 #协议验证 #自动化测试 #配置驱动 .TypeScript

评分 : 2.5分

下载量 : 15

更新时间 : 2025-04-23

安装

复制以下命令到你的Client进行配置

{
  "numTestsPerTool": 3,
  "timeoutMs": 10000,
  "outputFormat": "console",
  "outputPath": "./reports/results.json",
  "verbose": false,
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./"],
      "env": {
        "DEBUG": "true"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-token-here"
      }
    },
    "dev-server": {
      "command": "node",
      "args": ["/absolute/path/to/your/dev-server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

{
  "servers": ["filesystem", "dev-server"],
  "numTestsPerTool": 3,
  // other settings...
  "mcpServers": {
    // server definitions...
  }
}

{
  "mcpServers": {
    "my-dev-server": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 MCP 服务器测试器文档

MCP 服务器测试器是一款专门用于测试支持 MCP 协议服务器的工具。它可以连接到 MCP 服务器，发现可用工具，并执行自动化测试，以此来验证服务器的行为是否符合预期。

🚀 快速开始

基本设置

创建默认配置文件：
```
mcp-server-tester --init
```
编辑 mcp-servers.json 文件：添加您自己的服务器和配置。
创建 .env 文件：包含您的 Anthropic API 密钥。
```
echo "ANTHROPIC_API_KEY=your-api-key-here" > .env
```
运行测试：
```
mcp-server-tester
```

测试开发版本

在 mcp-servers.json 中添加开发服务器配置：

{
  "mcpServers": {
    "my-dev-server": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

然后运行测试：

mcp-server-tester

多配置文件测试

创建不同的配置文件以应对不同环境：

cp mcp-servers.json config-dev.json
cp mcp-servers.json config-prod.json

编辑每个文件并设置相应的配置，然后运行：

mcp-server-tester ./config-dev.json
mcp-server-tester ./config-prod.json

✨ 主要特性

能够连接到 MCP 服务器，发现可用工具。
执行自动化测试，验证服务器行为。
支持多配置文件测试，适应不同环境。
提供多种报告格式，方便查看和分析测试结果。

📦 安装指南

# 安装依赖
npm install

💻 使用示例

基础用法

# 运行测试器
node src/server.js

高级用法

# 使用不同配置运行
node src/server.js --config config-dev.json

📚 详细文档

配置选项

服务器配置

在 mcp-servers.json 中定义服务器：

{
  "mcpServers": {
    "server1": {
      "command": "node",
      "args": ["index.js"],
      "env": {}
    }
  }
}

测试设置

配置文件中的测试选项包括：

属性	详情
`numWorkers`	并行执行的工人数（默认：4）
`timeoutMs`	每个工具执行的最大时间（毫秒，默认：1000）
`outputFormat`	报告格式（支持：`console`、`json`、`html`，默认：`console`）
`outputPath`	输出文件路径（默认：`./test-results.json` 或 `stdout`）

测试流程

连接与发现

连接到服务器：测试器使用 TCP 协议连接到 MCP 服务器。
发现工具：通过 RPC 请求获取服务器支持的工具列表。

执行与验证

对于每个工具，测试器：

发起 RPC 请求。
等待响应。
验证结果是否符合预期。

报告格式

控制台输出（默认）

直接在终端显示测试结果。

JSON 报告

生成结构化的 JSON 文件，路径由 outputPath 指定。

HTML 报告

生成包含可视化界面的 HTML 文件，便于分析和查看。

故障排除

连接问题

确认服务器配置无误。
验证服务器是否支持 MCP 协议。
增加 timeoutMs 以应对慢服务器。
启用详细日志记录：设置 verbose: true。

API 密钥问题

确保 API 密钥有效且正确无误。
检查 .env 文件是否位于项目根目录。
验证密钥是否有空格或多余字符。

工具执行失败

确认服务器实现 MCP 协议正确。
查看服务器日志获取错误信息。
核实工具参数配置无误。

项目结构

mcp-server-tester/
├── package.json          # 项目依赖和脚本
├── src/                 # 源代码目录
│   ├── server.js        # 测试器主程序
│   └── worker.js        # 并行执行的工件
├── mcp-servers.json      # 服务器配置文件
└── .env                 # 环境变量文件

开发指南

代码结构

src/server.js：主程序，解析命令行参数并初始化测试。
src/worker.js：处理每个工具的执行和验证。
src/utils/：包含日志、RPC 请求等公用函数。

贡献指南

提交代码前，请确保通过所有单元测试。
为新功能或修复添加相关文档。
在 GitHub 上提交 Pull Request。

🔧 技术细节

MCP 服务器测试器通过 TCP 协议连接到 MCP 服务器，使用 RPC 请求与服务器进行通信。主程序 src/server.js 负责解析命令行参数并初始化测试，src/worker.js 处理每个工具的执行和验证。测试过程中，测试器会根据配置文件中的选项，并行执行多个工具的测试，并根据设置的报告格式生成相应的测试报告。