Wopee MCP 服务器

为您的应用提供 AI 驱动的自主测试——将 Claude、Cursor 或任何兼容 MCP 的 AI 代理连接到 Wopee.io，即可在几秒钟内生成测试用例、用户故事并运行自主测试。

npx wopee-mcp

文档 | 落地页 | 仪表盘

设置

前置要求

• Node.js（建议 v18 或更高版本）

• 支持 MCP（模型上下文协议）的 IDE，例如 Cursor 或 VSCode

MCP 服务器配置

将此服务器添加到您的 MCP 配置中。

配置示例

{
  "mcpServers": {
    "wopee": {
      "command": "npx wopee-mcp",
      "env": {
        "WOPEE_PROJECT_UUID": "your-project-uuid-here",
        "WOPEE_API_KEY": "your-api-key-here"
      }
    }
  }
}

必需的环境变量

• WOPEE_PROJECT_UUID - 您的 Wopee 项目 UUID。这用于标识您正在处理的项目。

• WOPEE_API_KEY - 您的 Wopee API 密钥。您可以在 cmd.wopee.io 的项目设置中创建一个。

可选的环境变量

• WOPEE_API_URL - Wopee API 端点 URL。仅在测试/开发目的时指定。

企业代理配置

如果您处于企业代理/VPN 环境中并遇到连接超时，可以使用标准环境变量配置代理设置：

{
  "mcpServers": {
    "wopee": {
      "command": "npx wopee-mcp",
      "env": {
        "WOPEE_PROJECT_UUID": "your-project-uuid-here",
        "WOPEE_API_KEY": "your-api-key-here",
        "HTTPS_PROXY": "http://your-proxy-server:8080"
      }
    }
  }
}

支持的代理环境变量

• HTTPS_PROXY 或 https_proxy - HTTPS 连接的代理服务器 URL（推荐）

• HTTP_PROXY 或 http_proxy - 后备代理服务器 URL

查找您的代理设置

如果您不确定代理设置，请检查 VS Code 设置 (settings.json) 中的 http.proxy 值，或咨询您的 IT 部门。常见的企业代理格式：

• http://proxy.company.com:8080

• http://10.x.x.x:8080

• http://username:password@proxy.company.com:8080（如果需要身份验证）

TLS / 证书问题

MCP 正常工作不需要此步骤。 如果您看到 HTTPS 或证书相关的错误，说明您的环境中存在 TLS 或证书信任问题。

如果服务器报错，例如 UNABLE_TO_VERIFY_LEAF_SIGNATURE 或 certificate has expired，可能是由于：

• 自签名证书（例如当 WOPEE_API_URL 指向内部或开发服务器时）

• 企业代理 / SSL 检查（流量被您的机器不信任的企业 CA 重新加密）

• Node 的信任存储中缺少 CA 证书

首选解决方案（安全）

1. 使用有效的 TLS 证书 – 例如 Let’s Encrypt 或内部 CA – 并确保提供了完整的证书链。

2. 安装企业或内部 CA 以便 Node 信任它：

   示例：

   export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/internal-ca.pem

   在 MCP 配置 env 中：

   "env": {
     "WOPEE_PROJECT_UUID": "your-project-uuid-here",
     "WOPEE_API_KEY": "your-api-key-here",
     "NODE_EXTRA_CA_CERTS": "/path/to/ca.pem"
   }

不安全的变通方法（不推荐）

仅用于本地调试，您可以禁用 Node 中的 TLS 验证。这绝不应在生产环境中使用，因为它会禁用 HTTPS 安全性并将流量暴露给拦截风险。

export NODE_TLS_REJECT_UNAUTHORIZED=0

或者在 MCP 配置 env 中：

"env": {
  "WOPEE_PROJECT_UUID": "your-project-uuid-here",
  "WOPEE_API_KEY": "your-api-key-here",
  "NODE_TLS_REJECT_UNAUTHORIZED": "0"
}

请将其视为仅限调试的应急方案，而非正常的设置步骤。

注意： 一些用户报告也设置了 PYTHONHTTPSVERIFY=0。此 MCP 服务器不使用 Python；该变量对其无效。它仅适用于您在同一环境中运行基于 Python 的 MCP 主机或其他执行 HTTPS 的工具时——这超出了本服务器的范围。

Related MCP server: Playwright MCP

入门指南

此 MCP 服务器中的大多数工具都需要 suiteUuid 才能运行。您有两种入门选择：

选项 1：使用现有套件

首先获取您现有的分析套件：

Use the wopee_fetch_analysis_suites tool to retrieve all available suites for your project.

这将返回所有分析套件及其 UUID 的列表，您可以将其用于其他工具。

选项 2：创建新套件

如果您还没有任何套件，有两个选择：

自动分析： 创建并分发完整的分析/爬取套件：

Use the wopee_dispatch_analysis tool to create and dispatch a new analysis/crawling suite.

空白套件： 创建一个空套件以进行手动配置：

Use the wopee_create_blank_suite tool to create a blank analysis suite.

这两个选项都会返回一个套件 UUID，您可以将其用于后续操作。

可用工具

套件管理

wopee_fetch_analysis_suites

获取您项目的所有分析套件。这是查看可用套件的良好起点。

• 返回： 包含 UUID、名称、状态和元数据的分析套件数组

使用示例：

Fetch all existing analysis suites for my project

wopee_dispatch_analysis

为您的项目创建并分发新的分析/爬取套件，或重新运行现有套件。使用此工具启动新的分析会话或重新触发之前的分析。

• 参数：

  • additionalInstructions (可选) - 指导代理在分析/爬取阶段的额外说明（例如重点区域、忽略事项、登录步骤等）

  • additionalVariables (可选) - 传递给分析的额外环境变量。对象数组，每个包含：

    • key - 变量名，必须仅包含大写字母和下划线（例如 MY_VAR, BASE_URL）

    • value - 变量值（非空字符串）

  • rerun (可选) - 如果提供，则重新运行现有的分析套件而不是创建新套件。对象包含：

    • suiteUuid - 要重新运行的现有套件的 UUID

    • analysisIdentifier - 现有套件的分析标识符

    • mode - 重新运行模式：FULL（重新运行整个分析，包括爬取和生成）或 CRAWLING（仅重新运行爬取阶段）

• 返回： 包含创建/重新运行的套件信息的成功消息

使用示例：

Dispatch a new analysis suite

Dispatch a new analysis suite and focus on the checkout flow

Dispatch a new analysis suite with additional variables CARD_FILAMENT=123321123 and AUTH_TOKEN=abc123

Rerun the full analysis for suite <suiteUuid> with analysis identifier <analysisIdentifier>

Rerun only the crawling phase for suite <suiteUuid> with analysis identifier <analysisIdentifier>

wopee_create_blank_suite

为您的项目创建一个空白分析套件。当您想手动配置和填充套件而不是自动分析时，请使用此工具。

• 返回： 包括其 UUID 在内的已创建套件信息

使用示例：

Create a blank analysis suite for my project

生成工具

这些工具为特定套件生成各种工件。所有工具都需要 suiteUuid 和 type 才能生成。

wopee_generate_artifact

为选定套件生成特定文件（工件）。

• 参数：

  • suiteUuid - 套件的 UUID

  • type - "APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES_WITH_TEST_CASES" | "TEST_CASES" | "TEST_CASE_STEPS" | "REUSABLE_TEST_CASES" | "REUSABLE_TEST_CASE_STEPS"

• 返回： 生成成功时的输出内容。

使用示例：

Generate app context for my most recent analysis suite

获取工具

这些工具用于检索特定套件生成的工件。所有工具都需要 suiteUuid 和 type。

wopee_fetch_artifact

从选定套件中获取查询的文件（工件）。

• 参数：

  • suiteUuid - 套件的 UUID

  • type - "APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "PLAYWRIGHT_CODE" | "PROJECT_CONTEXT"

  • identifier - 获取 Playwright 代码的测试用例标识符，例如 US003:TC004

• 返回： 获取成功时的文件内容。

使用示例：

Fetch user stories for the latest suite

更新工具

这些工具用于更新或设置特定套件的某些文件（工件）。需要 suiteUuid、type 和 content。

wopee_update_artifact

更新/替换特定套件的现有文件（工件）

• 参数：

  • suiteUuid - 套件的 UUID

  • type - "APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "PLAYWRIGHT_CODE" | "PROJECT_CONTEXT"

  • content - app context、general user stories 和 project context 的 Markdown 内容，user stories 的结构化 JSON

  • identifier - 获取 Playwright 代码的测试用例标识符，例如 US003:TC004

• 返回： 基于工具调用成功状态的布尔值

使用示例：

Update app context file for the most recent suite with this content: <YourMarkdown>

代理测试

wopee_dispatch_agent

分发自主测试代理以执行选定套件的测试用例。

• 参数：

  • suiteUuid - 包含测试用例的套件 UUID

  • analysisIdentifier - 套件的分析标识符

  • testCases - 要执行的测试用例对象数组，每个包含：

    • testCaseId - 测试用例 ID

    • userStoryId - 关联的用户故事 ID

• 返回： 包含初始执行状态（uuid, executionStatus, agentReportStatus, codeReportStatus 等）的已执行测试用例对象数组

使用示例：

Dispatch agent for my latest suite's user story US001 and test case TC003

测试结果

wopee_fetch_executed_test_cases

获取给定分析套件的已执行测试用例及其结果。使用此工具检查已分发代理运行的状态和报告。

• 参数：

  • suiteUuid - 要获取结果的分析套件 UUID

  • analysisIdentifier (可选) - 用于缩小结果范围的分析标识符（例如 A068）

• 返回： 按用户故事分组的结果数组，每个包含已执行的测试用例及其执行状态、代理报告、代理报告状态、代码报告和代码报告状态

使用示例：

Fetch test results for suite <suiteUuid>

Show me the executed test cases for my latest analysis suite

典型工作流程

1. 从套件开始：

   • 使用 wopee_fetch_analysis_suites 查看现有套件，或

   • 使用 wopee_dispatch_analysis 创建新套件

2. 生成工件：

   • 生成应用上下文：使用 APP_CONTEXT 和特定 suiteUuid 调用 wopee_generate_artifact

   • 生成通用用户故事：使用 GENERAL_USER_STORIES 和特定 suiteUuid 调用 wopee_generate_artifact

   • 生成带测试用例的用户故事：使用 USER_STORIES_WITH_TEST_CASES 和特定 suiteUuid 调用 wopee_generate_artifact

   • 生成可重用测试用例：使用 REUSABLE_TEST_CASES 和特定 suiteUuid 调用 wopee_generate_artifact

   • 生成可重用测试用例步骤：使用 REUSABLE_TEST_CASE_STEPS 和特定 suiteUuid 调用 wopee_generate_artifact

   • 生成测试用例步骤：使用 TEST_CASE_STEPS 和特定 suiteUuid 调用 wopee_generate_artifact

3. 获取生成的内容：

   • 使用获取工具检索生成的 Markdown/JSON 文件

4. 运行测试：

   • 使用 wopee_dispatch_agent 通过自主测试代理执行测试用例

5. 检查结果：

   • 使用 wopee_fetch_executed_test_cases 检查已分发代理运行的状态和报告

   • 或使用 fetch-test-results 提示词获取所有测试结果的格式化摘要

可用提示词

fetch-project-summary

获取分析套件及其用户故事/测试用例，然后显示包含两个 Markdown 表格的格式化摘要：套件概览和详细的测试用例分解。

fetch-test-results

获取分析套件及其已执行的测试用例结果，然后显示格式化的 Markdown 表格，展示每个测试用例的执行状态、代理报告状态和代码报告状态。同时显示失败的报告详情。

注意事项

• 大多数工具需要 suiteUuid。请务必从获取或创建套件开始。

• wopee_dispatch_analysis 工具将完成整个处理周期——爬取应用程序并逐一生成所有文件（工件）。

• 建议使用 cmd.wopee.io 以方便地直观展示生成的数据和代理运行结果。