内容
align="center">
# ⚡ MaxoPerf MCP 服务器
### 通过任意 AI 代理驱动整个 MaxoPerf 平台 — 使用您的 API 密钥。
**一个远程托管的 [模型上下文协议](https://modelcontextprotocol.io) 服务器，将 Claude、Cursor、Codex、VS Code Copilot 和 ChatGPT 转换为一个完整的性能测试操作员。创建测试，在托管的云运行器上启动负载测试，读取结果，并获取根本原因分析 — 所有操作都使用自然语言，通过您的密钥进行身份验证。**
[](https://modelcontextprotocol.io)
[](https://claude.ai)
[](https://cursor.com)
[](https://chatgpt.com)
```
https://app.maxoperf.com/mcp
```
</div>
---
## 配置
这是一个**远程托管**的服务器 — 无需安装或运行。将其添加到您的 MCP 客户端配置中，并设置 `MAXOPERF_API_KEY`（在控制台中创建 → **设置 → API 密钥**）：
```json
{
"mcpServers": {
"maxoperf": {
"type": "http",
"url": "https://app.maxoperf.com/mcp",
"headers": {
"Authorization": "Bearer ${MAXOPERF_API_KEY}"
}
}
}
```
您的密钥调用时都会被真实平台验证（身份验证、租户、OpenFGA、审计）— 服务器不会存储任何数据，也不会增加新的信任边界。吊销密钥后，访问权限将立即失效头部 `X-MaxoPerf-MCP-Mode: read-only获取只读会话（隐藏）。
## 安装（客户端）
**Claude — 插件捆服务器**和**代理技能：
```
/plugin marketplace add Maxocp
/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/`](./packaging) 中。所有配置都使用上述相同的 `mcpServers` 块。
---
## 工具
29 个精选工具。读取默认为 `response_format: "concise"`（传递 `"detailed"` 以获取完整有效载荷）；写入工具只读会话，`cancel_run` 在模式下隐藏。
**上下文和租户 `whoami` — 解析您的 API 密钥背后的帐户和默认工作区
- `list_workspaces` — 列出对帐户可见的工作区
- `set` — 设置会话的活动工作区
list_projects` — 列出项目（/删除权限）
- `create_project`项目
**测试**
- `list — 列出按项目/工作区/类型过滤）
- `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` — 关键绩效指标概览：吞吐量、延迟百分位数、错误率
- `_metrics` — 时间序列指标（延迟/吞吐量/错误/负载/健康状况）
- `get_run_errors` — 分组错误行（消息/计数/代码）
**诊断 — 根本原因和异常检测**
- `get_run_summary` — 高管摘要哪些故障标准被触发
- `get_run_error_bodies` — 采样的错误请求正文 + 状态代码 `get_run_logs` — 错误级别的引擎/系统日志 `get_runner_health` — 运行器 CPU/内存 目标 Vus 与峰值达到 Vus（vuShort）
- `detect_run_anomalies` — 确定棒离群点扫描位数/MAD）；终端门控，低假阳性
生口和发现**
- `call_platform_api` —公共 `/v1/*`（秘密、环境、计划、BYOC）；管理员/内部拒绝列表，SSRF 安全
- `get_openapi` — 公共 OpenAPI 文档
- `search_endpoints` — API 以找到正确的端## 提示
编码序列的文本配方 —无法读取存储库的仅：
- `run-load-test` — 启动基准测试并观察其完成
- `diagnose-latency-regression` — 比较两个运行的 p95
- `summarize-run 运行的纯语言摘要 `plan-and-build-test` — 将目标转换为项目 → 测试 → 上传 → 运行
- `utor` — 推荐引擎（k6 / JMeter / Playwright / Selenium）
- `scan-endpoints-for-hotspots 从 OpenAPI 规范或粘贴的列表中排名热点
- `setup-secrets-and-envs` — 在连接工作区秘密 + 多环境
- `diagnoseailure` — 运行失败根本原因
- `explainomalies` — 解释每个检测到的离群## 资源
- `maxoperf://openapi` — 公共 OpenAPI 规范
- `maxoperf://run/{id}` — 运行报告摘要
---
## 试用
- "负载测试 https://api.example.com/checkout，500 用户，持续 5 分钟，如果 p95 超过 800ms，则失败。"
- "扫描我的存储库中值得负载测试的端点，然后为风险最高的端点构建和运行测试。"
- "为什么运行 run-0000000001 失败？检查错误、日志和运行器是否实际达到目标负载。"
## 与大脑配对
MCP 服务器是**手**。捆绑MaxoPerf 代理https://github.com/Perf/agent-skill)**px @maxoperf/agent-skill install`，包含在 Claude 插件中，或在 [`agent-skill/`](./agent-skill) 中) 是**大脑** — 它读取您的代码，找到热点，构建和运行测试，并诊断失败原因，自动驱动这些工具。
## 存储库中有什么
| 路径 | 内容 |
| --- | --- |
| [`.claude-plugin/`](./.claude-plugin) | Claude Code 插件（捆绑 MCP 连接器 + 技能） |
| [`agent-skill/`](./agent-skill) | `maxoperf` 代理技能的副本（规范首页：[MaxoPerf/agent-skill](https://github.com/MaxoPerf/agent-skill)) |
| [`packaging/`](./packaging) | MCP 注册表 `server.json`、`.mcpb`、VS Code / Cursor 深度链接、Codex / ChatGPT 设置 |
| [`LAUNCHGUIDE.md`](./LAUNCHGUIDE.md) | MCP 目录列表元数据 |
---
<div align="center">
**[开始使用 →](https://maxoperf.com)** · **[代理技能 →](https://github.com/MaxoPerf/agent-skill)** · **[文档 →](https://maxoperf.com/docs)**
<sub>MaxoPerf monorepo 的只读镜像。在 [maxoperf.com](https://maxoperf.com) 上报告问题。</sub>
</div>
