Testdino MCP

🚀 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 個強大的工具：

1. health - 驗證連接並確認 API 密鑰的有效性。
2. list_testruns - 使用過濾器（分支、時間、作者、提交、環境）瀏覽測試運行。
3. get_run_details - 獲取特定測試運行的全面詳細信息。
4. list_testcase - 使用全面的過濾器（按測試運行、狀態、瀏覽器、錯誤類別、分支、環境、提交、作者等）列出測試用例。
5. get_testcase_details - 獲取特定測試用例的詳細信息。
6. 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 密鑰

1. 登錄你的 TestDino 賬戶
2. 導航至 設置 → API 密鑰
3. 生成新的或複製現有的 API 密鑰

步驟 2：配置 Cursor

1. 打開或創建 MCP 配置文件：

   • Windows：%APPDATA%\Cursor\mcp.json
   • macOS/Linux：~/.cursor/mcp.json
   • 特定項目：項目根目錄下的 .cursor/mcp.json

2. 如果你使用 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：重啟並驗證

1. 完全關閉並重新啟動 Cursor
2. 通過詢問來驗證連接：“檢查 TestDino 健康狀況”
3. 如果一切正常，你應該會看到項目名稱和 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（用於包管理）