JinDaGe - testdino-mcp MCP Details

article

README

🚀 TestDino MCP

TestDino MCP 是一个模型上下文协议（MCP）服务器，用于将 TestDino 与 AI 代理连接起来。借助该服务器，你可以直接通过自然语言命令与 TestDino 测试数据进行交互。

🚀 快速开始

TestDino MCP 服务器在 TestDino 测试管理平台和 AI 代理之间架起了一座桥梁。你无需再手动操作 TestDino 仪表盘，只需向 AI 助手下达指令，就能实现以下功能：

查看测试运行结果
分析测试失败原因
上传测试结果
获取详细的测试用例信息

一切都能通过简单的对话式命令完成。

✨ 主要特性

🔍 健康检查：验证 API 连接并确认 TestDino API 密钥的有效性。
📊 测试运行管理：列出并检索测试运行的详细信息，支持强大的过滤选项。
🧪 测试用例分析：获取单个测试用例的全面详细信息，包括错误、日志和执行步骤。
📤 测试上传：将本地机器上的 Playwright 测试结果自动上传到 TestDino。
🔌 兼容 MCP：基于模型上下文协议标准构建，可与任何兼容 MCP 的 IDE 或 AI 代理进行配置。
⚡ 轻松设置：使用 npx 可在几分钟内完成安装和配置。
🔐 安全可靠：API 密钥安全地存储在本地配置中。

可用工具

服务器提供了 6 个强大的工具：

health - 验证连接并确认 API 密钥的有效性。
list_testruns - 使用过滤器（分支、时间、作者、提交、环境）浏览测试运行。
get_run_details - 获取特定测试运行的全面详细信息。
list_testcase - 使用全面的过滤器（按测试运行、状态、浏览器、错误类别、分支、环境、提交、作者等）列出测试用例。
get_testcase_details - 获取特定测试用例的详细信息。
upload_latest_local_test_runs - 上传本地的 Playwright 测试结果。

📦 安装指南

主要有 3 种使用 TestDino MCP 的选项：

选项 1：通过 npx（推荐 - 无需安装）

无需安装
需要时自动下载并运行
始终使用最新版本
可在任何兼容 MCP 的平台上配置

选项 2：全局安装

npm install -g testdino-mcp

只需安装一次，即可在任何项目中使用
需要 Node.js 18+ 和 npm
使用命令：testdino-mcp

选项 3：项目安装

npm install testdino-mcp

安装在项目的 node_modules 中
使用命令：npx testdino-mcp

📚 详细文档

Cursor IDE 简单集成指南：

步骤 1：获取 API 密钥

登录你的 TestDino 账户
导航至 设置 → API 密钥
生成新的或复制现有的 API 密钥

步骤 2：配置 Cursor

打开或创建 MCP 配置文件：
- Windows：%APPDATA%\Cursor\mcp.json
- macOS/Linux：~/.cursor/mcp.json
- 特定项目：项目根目录下的 .cursor/mcp.json
如果你使用 npx 或在项目内安装，添加以下配置：

{
  "mcpServers": {
    "TestDino": {
      "command": "npx",
      "args": ["-y", "testdino-mcp"],
      "env": {
        "TESTDINO_API_KEY": "your_testdino_api_key_here"
      }
    }
  }
}

重要提示：将 your_testdino_api_key_here 替换为你在步骤 1 中获取的实际 API 密钥。

步骤 3：重启并验证

完全关闭并重新启动 Cursor
通过询问来验证连接：“检查 TestDino 健康状况”
如果一切正常，你应该会看到项目名称和 ID！

替代方案：全局安装

如果你更喜欢全局安装而不是使用 npx 或项目安装：

npm install -g testdino-mcp

然后使用以下配置：

{
  "mcpServers": {
    "TestDino": {
      "command": "testdino-mcp",
      "env": {
        "TESTDINO_API_KEY": "your_testdino_api_key_here"
      }
    }
  }
}

该服务器使用标准的 MCP 协议，因此它也可以与其他兼容 MCP 的客户端配合使用。

💻 使用示例

配置完成后，只需用自然语言与你的 AI 助手交流即可。重要提示：工具需要在 mcp.json 中配置 TESTDINO_API_KEY。

示例命令

在 Cursor 或 Claude Desktop（或其他兼容 MCP 的客户端）中尝试以下自然语言命令：

连接与设置：

"检查我的 TestDino 连接是否正常"
"验证我的 TestDino API 密钥"

探索测试运行：

"显示我最近的 5 次测试运行"
"开发分支上有哪些测试运行？"
"列出最近 3 天的测试运行"
"显示作者为 john 的测试运行"
"查找提交 abc123 的测试运行"
"列出生产环境中的所有测试运行"

分析测试结果：

"获取测试运行 test_run_6901b2abc6b187e63f536a6b 的详细信息"
"获取测试运行编号 42 的详细信息"
"测试运行 test_run_6901b2abc6b187e63f536a6b 中有哪些测试用例失败了？"
"显示最近一次测试运行中的所有不稳定测试用例"
"列出生产环境中所有失败的测试用例"
"显示主分支上执行时间超过 100 秒的测试用例"
"查找提交 abc123 中测试用例的所有超时问题"

上传结果：

"上传我的 Playwright 测试结果"
"上传 ./test-results 目录中的测试结果"

🔧 技术细节

要求

Node.js 18.0.0 或更高版本
NPM（用于包管理）

testdino-mcp