AREX API MCP Server

一个用于辅助问题排查的 MCP server，通过 recordId 获取 AREX 回放测试的用例详情，帮助 AI 分析二方接口的请求响应数据。

功能

提供一个 tool：get_case_detail_list，用于：

• 获取 AREX 回放测试的用例详情数据
• 查看二方接口的请求参数和响应结果
• 对比录制和回放的差异
• 辅助 AI 根据代码排查用户问题

安装

npm install
npm run build

配置

在 Cursor 的 MCP 设置中添加以下配置：

{
  "mcpServers": {
    "arex-api": {
      "command": "npx",
      "args": ["-y", "/Users/yyy/workspace/projectb/mcp"]
    }
  }
}

使用场景

典型问题排查流程

1. 用户报告问题

   用户：某个接口回放时返回结果不对，recordId 是 AREX-10-175-152-194-659211758213388

2. AI 调用 MCP 获取数据

   {
     "tool": "get_case_detail_list",
     "arguments": {
       "recordId": "AREX-10-175-152-194-659211758213388"
     }
   }

3. AI 分析响应数据

   • 查看请求参数是否正确
   • 对比录制时的响应和当前响应
   • 分析差异原因（数据变化、逻辑变化、配置变化等）
   • 根据代码定位问题

4. 给出排查结论

   • 明确问题原因
   • 提供修复建议
   • 标注相关代码位置

Tool 详情

get_case_detail_list

参数：

• recordId (string, 必需): AREX 测试记录 ID

返回格式：

# AREX 回放测试用例详情

**Record ID**: AREX-10-175-152-194-659211758213388
**查询时间**: 2026-03-16 10:00:00
**接口地址**: http://reversetestmng.qa.ie.17usoft.com/record/caseDetailList?recordId=xxx

---

## 响应数据

```json
{
  "success": true,
  "data": [...],
  ...
}

数据摘要

• 请求状态: ✅ 成功
• 用例数量: 5 条 ...

💡 提示: 以上数据可用于对比录制请求参数、分析响应差异、排查业务逻辑问题

## 开发

```bash
# 监听模式编译
npm run dev

# 构建
npm run build

API 接口

• Base URL: http://reversetestmng.qa.ie.17usoft.com
• Endpoint: /record/caseDetailList
• Method: GET
• Query Parameters: recordId