内容
# crowd-test-mcp 🔥
**随时可用的模拟人群 — 为 [crowd-test](https://github.com/anhhuyn411-alt/crowd-test) 而设计的 MCP 服务器。**
询问 Claude Desktop、Claude Code、Cursor 或任何 MCP 客户端，以释放一群 AI 虚拟用户 — 不耐心的购物者、困惑的老人、仅使用键盘的用户、混乱的猴子 — 访问您的网站。他们在真实的 Chromium 浏览器中浏览网站，记录发现的问题，并提交一份带有 **生存等级** （S–F）的损伤报告。
> *"将模拟人群发送到 https://staging.myapp.com，并告诉我首先要修复什么。"*
这就是现在的工作流程。
## 安装
```bash
pip install crowd-test-mcp
```
服务器环境中需要一个 LLM 密钥：`ANTHROPIC_API_KEY` 或 `OPENAI_API_KEY`。
### Claude Code
```bash
claude mcp add crowd-test -e ANTHROPIC_API_KEY=sk-... -- crowd-test-mcp
```
### Claude Desktop / Cursor / 任意 MCP 客户端
```json
{
"mcpServers": {
"crowd-test": {
"command": "crowd-test-mcp",
"env": { "ANTHROPIC_API_KEY": "sk-..." }
}
}
}
```
## 工具
| 工具 | 功能 |
|---|---|
| `run_crowd_test` | 将模拟人群发送到指定 URL。选择人物，添加随机模拟人群，设置目标，选择验证深度（`none` / `detective` / `cross` / `tribunal`）。返回简洁的损伤摘要；完整 markdown/HTML 报告保存在 `~/crowd-test-reports/`。 |
| `list_personas` | 内置的十个人物及其各自的测试内容。 |
| `preview_mob` | 预览指定数量和种子生成的随机模拟人群。 |
| `read_report` | 从磁盘中获取最新的完整 markdown 报告。 |
## 验证委员会
发现的问题可以由最多三个独立的测试框架进行交叉审查，然后再计入等级 — 一个持怀疑态度的侦探代理人，一个原始的 Playwright 探针和一个 [Microsoft Webwright](https://github.com/microsoft/Webwright) 代理人。自动化工件会进行争议，而不是惊慌。详情请参见 [crowd-test README](https://github.com/anhhuyn411-alt/crowd-test#the-tribunal-%EF%B8%8F)。
更深层次的测试需要一次性额外的安装：
```bash
pip install crowd-test[probe] && playwright install chromium # verify="cross"
pip install git+https://github.com/microsoft/Webwright # verify="tribunal"
```
## 需要注意的事项
- **测试需要几分钟，而不是几秒钟** — 每个角色都驱动一个真实的浏览器。首先使用 2–3 个角色；当您需要时，可以升级到 `mob=10`。
- **只测试您自己的内容。** 模拟人群仅适用于您自己的预发布和生产站点，而不是其他人的站点。
- 报告默认保存在 `~/crowd-test-reports/<host>-<timestamp>/`。
## 许可证
[MIT](LICENSE)
