@assert-click/mcp

Assert 的 MCP 服务器 — 让您的 AI 编码助手无需离开聊天界面即可生成、运行和检查 E2E 测试。

用简单的英语描述用户流程。Assert 会生成 Playwright 测试，在真实的浏览器中执行它，并返回步骤级的测试结果和失败截图 — 所有这些都只需在 Cursor、Claude、Windsurf 或任何兼容 MCP 的代理中进行一次工具调用即可完成。

在 assert.click 免费注册 以在使用此包之前获取您的 API 密钥和项目 ID。

您的代理可以做什么

生成 — 描述一个流程，获取可保存并运行的 Markdown 场景
运行 — 针对真实的 Chromium 浏览器执行已保存的场景或即时 Markdown
检查 — 获取步骤级的通过/失败状态、错误消息和失败截图 URL
列表 — 浏览项目的已保存场景

要求

Node.js >=18.17
项目范围的 Assert 密钥 — 在 assert.click 获取

设置

1. 在您的仓库中创建 assert.config.json：

{
  "projectApiKey": "assert_project_key_here",
  "projectId": "project_123"
}

2. 将 MCP 服务器添加到您的代理配置中：

{
  "mcpServers": {
    "assert": {
      "command": "npx",
      "args": ["-y", "@assert-click/mcp"],
      "env": {
        "ASSERT_CONFIG": "/absolute/path/to/assert.config.json"
      }
    }
  }
}

就是这样。您的代理现在可以访问所有四个 Assert 工具。

环境变量

ASSERT_API_KEY: API 密钥（存储在 assert.config.json 中的替代方案）
ASSERT_PROJECT_ID: 可选的默认项目 ID
ASSERT_CONFIG: 可选的配置文件或目录路径

配置文件

MCP 服务器将从当前目录向上查找这些文件：

assert.config.json
assert.config.local.json

assert.config.local.json 会合并在 assert.config.json 之上。

如果您更喜欢基于环境变量的密钥而不是提交密钥：

{
  "projectApiKeyEnv": "ASSERT_API_KEY",
  "projectId": "project_123"
}

工具

`assert_generate`

根据简单的英语描述生成 Markdown 场景。

输入：

description: string — 用户应该能够做什么
url: string — 起始 URL
project_id?: string
save?: boolean — 保存到项目（默认：true）

{
  "scenario_id": "scenario_123",
  "markdown": "URL: https://example.com/login\nSCENARIO: Login\nPROCESS:\n  - Fill \"email\" with \"user@example.com\"\nEXPECT: Dashboard",
  "saved": true
}

`assert_run`

在真实的浏览器中执行已保存的场景或即时 Markdown。

输入：

scenario_id?: string
markdown?: string
project_id?: string
request_id?: string

必须提供 scenario_id 或 markdown 中的一个。

{
  "run_id": "run_123",
  "status": "queued",
  "estimated_duration_seconds": null
}

`assert_status`

获取运行的步骤级结果。

输入：

run_id: string

{
  "run_id": "run_123",
  "status": "passed",
  "duration_ms": 4200,
  "steps": [
    {
      "description": "Fill email",
      "status": "passed",
      "error": null,
      "screenshot_url": null
    }
  ],
  "failure_summary": null,
  "full_log_url": null
}

`assert_list`

列出项目的已保存场景。

输入：

project_id?: string
cursor?: string
limit?: number

{
  "scenarios": [
    {
      "id": "scenario_123",
      "name": "Login flow",
      "project_id": "project_123",
      "last_run_status": "passed",
      "last_run_at": "2026-03-31T10:00:00.000Z",
      "url": "https://example.com/login"
    }
  ],
  "next_cursor": null
}

错误

错误以结构化 JSON 形式返回：

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The ASSERT_API_KEY is invalid or missing.",
    "field": null
  }
}

常见代码：

INVALID_API_KEY
SCENARIO_NOT_FOUND
RUN_NOT_FOUND
VALIDATION_ERROR
UPSTREAM_ERROR

许可证

MIT

Assert

@assert-click/mcp

您的代理可以做什么

要求

设置

环境变量

配置文件

工具

`assert_generate`

`assert_run`

`assert_status`

`assert_list`

错误

许可证

Resources

Tools

Latest Blog Posts

MCP directory API