MaxoPerf MCP

https://app.maxoperf.com/mcp

配置

这是一个远程托管服务——无需安装或运行任何内容。将以下配置添加到你的 MCP 客户端配置中，并设置 MAXOPERF_API_KEY（在控制台 → 设置 → API 密钥中创建）：

{
  "mcpServers": {
    "maxoperf": {
      "type": "http",
      "url": "https://app.maxoperf.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MAXOPERF_API_KEY}"
      }
    }
  }
}

平台会在每次调用时验证你的密钥（身份验证、租户隔离、OpenFGA、审计）——该服务不存储任何内容，也不会引入新的信任边界。撤销密钥后，访问权限会立即失效。发送请求头 X-MaxoPerf-MCP-Mode: read-only，即可开启只读会话（写入工具将被隐藏）。

安装（选择你的客户端）

Claude Code — 插件内置了服务和 Agent 技能：

/plugin marketplace add MaxoPerf/mcp
/plugin install maxoperf

或者仅添加连接器：

claude mcp add --transport http maxoperf https://app.maxoperf.com/mcp \
  --header "Authorization: Bearer ${MAXOPERF_API_KEY}"

Cursor · VS Code / Copilot · Codex · ChatGPT · Claude Desktop — packaging/ 中提供一键深层链接和可复制粘贴的配置。它们都使用上方相同的 mcpServers 配置块。

工具

29 个精选工具。读取操作默认使用 response_format: "concise"（传入 "detailed" 可获取完整载荷）；写入工具需要非只读会话，且 cancel_run 在只读模式下不可见。

上下文与租户

• whoami — 根据你的 API 密钥解析账户和默认工作区
• list_workspaces — 列出账户可见的工作区
• set_active_workspace — 设置会话的活动工作区
• list_projects — 列出项目（含编辑/删除权限）
• create_project — 创建项目

测试

• list_tests — 列出测试（按项目/工作区/类型筛选）
• get_test — 获取单个测试及其验证摘要
• create_test — 创建测试框架（选择引擎/执行器）
• get_test_overview — 查看测试的运行历史概览

测试文件

• upload_test_file — 一次调用即可上传脚本/数据文件（真实的 3 步预签名流程）
• list_test_files — 列出测试文件及上传状态
• download_test_file — 获取文件的短时有效下载 URL

运行

• start_run — 在托管云运行器上启动负载/浏览器运行（幂等）
• get_run_status — 轮询生命周期状态（排队 → 运行中 → 通过/失败/已取消）
• list_runs — 带筛选条件的分页运行历史
• cancel_run — 取消运行（破坏性操作；只读模式下不可见）
• rerun_run — 根据快照或当前测试重新运行
• add_runners — 在现有位置扩展正在运行的任务

结果

• get_run_results — KPI 概览：吞吐量、延迟百分位数、错误率
• query_run_metrics — 时间序列指标（延迟/吞吐量/错误/负载/健康状况）
• get_run_errors — 分组错误条目（消息/数量/代码）

诊断 — 根因分析与异常检测

• get_run_summary — 执行摘要及触发的失败条件
• get_run_error_bodies — 抽样的错误请求/响应正文及状态代码
• get_run_logs — 错误级别的引擎/系统日志行
• get_runner_health — 运行器 CPU/内存趋势及 targetVus 与 peakAchievedVus 对比（vuShortfallPct）
• detect_run_anomalies — 确定性稳健离群值扫描（中位数/MAD）；仅在终态运行中执行，误报率低

应急接口与发现

• call_platform_api — 访问任意公开的 /v1/* 端点（机密、环境、计划、BYOC）；禁止访问管理员/内部端点，并可防止 SSRF
• get_openapi — 公开的 OpenAPI 文档
• search_endpoints — 在 API 中按关键字搜索，找到合适的端点

提示词

编码正确工具调用顺序的文本配方 — 非常适合无法读取代码仓库的纯聊天客户端：

• run-baseline-load-test — 启动基线运行并持续观察，直到完成
• diagnose-latency-regression — 比较两次运行的 p95
• summarize-run — 用通俗语言总结一次运行
• plan-and-build-test — 将目标转化为项目 → 测试 → 上传 → 运行
• choose-executor — 推荐引擎（k6 / JMeter / Playwright / Selenium）
• scan-endpoints-for-hotspots — 根据 OpenAPI 规范或粘贴的列表，按可能的热点排序
• setup-secrets-and-envs — 在运行前配置工作区机密和多环境
• diagnose-run-failure — 对失败运行的根因进行排序
• explain-run-anomalies — 解释检测到的每个离群值

资源

• maxoperf://openapi — 公开的 OpenAPI 规范
• maxoperf://run/{id} — 运行报告摘要

试试看

• “对 https://api.example.com/checkout 进行负载测试，使用 500 个用户，持续 5 分钟；如果 p95 超过 800ms，则判定失败。”
• “扫描我的代码仓库，找出最值得进行负载测试的端点，然后为风险最高的端点构建并运行测试。”
• “运行 run-0000000001 为什么失败了？检查错误和日志，并确认运行器是否确实达到了目标负载。”

与大脑搭配使用

MCP 服务是双手。捆绑的**MaxoPerf agent skill（npx @maxoperf/agent-skill install、包含在 Claude 插件中，或位于此处的 agent-skill/）是大脑**——它会读取你的代码、找到性能热点、构建并运行测试，并诊断问题原因，自动驱动这些工具。

此仓库包含什么