AI导哈

MCP服务器压力测试工具

用于对MCP（Model Context Protocol）服务器进行压力测试的工具，支持多种负载模式和实时监控。

  • by dgellow
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dgellow/mcp-stress

使用说明

mcp应激

MCP（模型上下文协议）服务器的压力测试工具。

安装

# npm
npx mcp-stress <command>
npm install -g mcp-stress

# JSR / Deno
deno install -g -A --name mcp-stress jsr:@dgellow/mcp-stress/cli

命令

跑

对MCP服务器执行压力测试。

# Stdio transport (spawns the server)
mcp-stress run -d 30 -c 10 --tool echo -- node my-server.js

# HTTP transport
mcp-stress run -d 30 -c 10 --url http://localhost:3000/mcp

# Find max throughput (auto-scales concurrency)
mcp-stress run -p find-ceiling -d 120 -c 50 -- node my-server.js

# CI mode: JSON output + assertions
mcp-stress run --json --assert "p99 < 500ms" --assert "error_rate < 1%" -- node my-server.js

# Live browser dashboard
mcp-stress run --live -d 60 -c 10 -o results.ndjson -- node my-server.js

# Send exactly N requests (useful for debugging)
mcp-stress run -n 5 -v -- node my-server.js

选项：

标志 描述
-p, --profile 工作负载配置文件（默认值： tool-flood)
-d, --duration 测试持续时间（秒）（默认值：10）
-n, --requests N个请求后停止（覆盖持续时间）
-c, --concurrency 峰值并发工作者（默认值：1）
-t, --timeout 请求超时（毫秒）（默认值：30000）
--tool 按名称定位特定工具
--shape 负载形状： constant, linear-ramp, exponential, step, spike, sawtooth
-o, --output NDJSON输出文件路径
--live 打开实时浏览器仪表板
--json 将JSON摘要输出到stdout
--assert 阈值断言，可重复（例如。 "p99 < 500ms")
--seed PRNG种子可重复性
--sse 使用传统的HTTP+SSE传输（默认：可流式传输HTTP）
-v, --verbose 记录每个请求/响应

图表

从上次运行生成交互式HTML报告。

mcp-stress chart results.ndjson --open

比较

比较两次测试运行并检测回归。

mcp-stress compare baseline.ndjson current.ndjson --open
mcp-stress compare baseline.ndjson current.ndjson --json --assert "p99_delta < 10%"

诊断

探测服务器连接和协议合规性。

mcp-stress diagnose -- node my-server.js
mcp-stress diagnose --url http://localhost:3000/mcp

发现

枚举服务器功能（工具、资源、提示）。

mcp-stress discover -- node my-server.js

轮廓/形状

列出可用的工作负载配置文件和负载形状。

mcp-stress profiles
mcp-stress shapes

运输

  • 标准 （默认）：将服务器作为子进程生成。使用 -- command [args].
  • 流式HTTP：连接到正在运行的服务器。使用 --url.
  • 上海证券交易所 （遗留）：使用 --url 随着 --sse.

输出

所有测试数据都以NDJSON（换行符分隔的JSON）形式编写，带有三个事件 类型：

  • meta --运行参数和配置
  • request --单个请求结果（方法、延迟、正常/错误）
  • summary --综合统计

发展

./scripts/lint     # Format check + type check
./scripts/test     # Run tests
./scripts/build    # Compile binary + npm packages
./scripts/start    # Run the CLI

相关 MCP