MCP基准测试工具

一个独立的npx兼容工具,用于对MCP(模型上下文协议)工具进行基准测试,支持并行测试、自定义项目和生成详细报告。

  • by AnEntrypoint
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 AnEntrypoint/mcp-benchmark

使用说明

MCP基准测试运行器

一个独立的、兼容npx的工具,用于对MCP(模型上下文协议)工具进行基准测试。

特点/功能

  • 通用MCP支持与任何可通过npx加载的MCP工具兼容
  • 并行测试进行基线与MCP(多通道处理或特定比较点,根据上下文确定具体含义)测试,以进行准确比较
  • 定制项目使用您自己的代码库进行测试或使用默认测试项目
  • 详细报告生成性能指标和可操作的建议
  • 清洁输出简洁易读的控制台输出

安装

npm install -g mcp-benchmark

使用方法

基本用法

mcp-benchmark

使用自定义MCP工具

mcp-benchmark --mcp-tool @modelcontextprotocol/server-github

带有论据/论点

mcp-benchmark -m @modelcontextprotocol/server-brave-search -a "--api-key YOUR_KEY"

带有自定义项目

mcp-benchmark -p ./my-project

高级选项

mcp-benchmark \
  --mcp-tool @modelcontextprotocol/server-github \
  --custom-project ./my-app \
  --timeout 1800000 \
  --output-dir results

选项

选项 描述 默认值
-m, --mcp-tool MCP工具用于基准测试 @modelcontextprotocol/server-github
-a, --mcp-args MCP 工具的附加参数 []
-p, --custom-project 自定义项目的路径 null
-t, --timeout 测试超时时间(毫秒) 300000
-o, --output-dir 结果输出目录 results
-h, --help 显示帮助信息 -

它是如何工作的

  1. 设置创建使用和不使用MCP工具的测试环境
  2. 测试并行运行基线与MCP性能的对比测试
  3. 分析测量执行时间、成功率和工具使用情况
  4. 报告生成详细的性能指标和建议

输出

该工具生成:

  • 控制台输出实时测试进度和结果
  • JSON 结果详细性能数据如下 results/ 目录
  • **SUGGESTIONS.md 翻译为中文是:“建议.md”**AI生成的改进建议

示例

基准GitHub MCP服务器

mcp-benchmark -m @modelcontextprotocol/server-github

基准定制MCP工具

mcp-benchmark -m @myorg/mcp-tool -a "--config ./config.json"

与您的项目进行基准对比

mcp-benchmark -p ./my-node-project

发展

# Clone and run locally
git clone <repository>
cd mcp-benchmark
npm install
npm start

做出贡献

  1. 为仓库创建分支(或:克隆仓库)
  2. 创建一个特性分支
  3. 做出你的更改
  4. 提交拉取请求

许可证

麻省理工学院(MIT)