什麼是TestRail MCP Server?

TestRail MCP Server是一個連接TestRail測試管理系統的中間件，它允許用戶通過AI助手(如Claude)或支持MCP協議的客戶端(如Cursor)直接與TestRail交互，無需切換應用即可完成測試管理任務。

如何使用TestRail MCP Server?

只需簡單配置MCP客戶端連接信息，即可開始通過自然語言命令管理TestRail中的測試項目、用例和運行結果。系統會自動處理API調用和響應轉換。

適用場景

適合測試團隊在編寫測試用例、規劃測試運行、記錄測試結果時提高工作效率，特別適合需要頻繁與測試管理系統交互的敏捷開發環境。

主要功能

項目管理查看和獲取TestRail中的項目信息

測試套件管理添加、更新和查詢測試套件

測試用例管理全面的測試用例操作，包括添加、更新、刪除、移動和複製

測試運行管理創建和更新測試運行，獲取運行詳情

測試結果記錄為測試用例添加結果，支持批量操作

優勢與侷限性

優勢

無需離開AI對話界面即可完成TestRail操作

支持自然語言交互，降低使用門檻

自動處理API調用細節，簡化集成過程

通過npx自動更新，無需手動維護

侷限性

需要Node.js運行環境

長對話可能導致性能問題，需使用分頁參數

部分高級功能仍需通過TestRail原生界面完成

如何使用

安裝Node.js

確保系統已安裝Node.js運行環境

配置MCP客戶端

在MCP客戶端配置文件中添加TestRail服務器連接信息

開始使用

在支持的客戶端中通過自然語言命令與TestRail交互

使用案例

查詢測試用例獲取特定項目下的所有測試用例

記錄測試結果為測試運行中的用例添加通過/失敗結果

創建迴歸測試套件基於現有用例創建新的測試套件

常見問題

出現'spawn node ENOENT'錯誤怎麼辦?

如何解決連接被拒絕(ECONNREFUSED)錯誤?

為什麼獲取測試用例時響應很慢?

如何更新到最新版本?

🚀 TestRail MCP 服務器

TestRail MCP 服務器提供了與 TestRail 直接交互的工具，可在 Claude AI 以及其他支持 MCP 的客戶端（如 Cursor）中使用。藉助該服務器，用戶無需離開與 AI 的對話，就能對測試用例、項目、套件、運行等進行管理。

🚀 快速開始

連接 MCP 服務器

您可以通過以下方式連接此 MCP 服務器。此方法使用 npx 自動下載並運行最新版本的包，無需本地安裝。

// 示例配置使用 npx
{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["@bun913/mcp-testrail@latest"],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io", // 替換為您的 TestRail URL
        "TESTRAIL_USERNAME": "your-email@example.com", // 替換為您的 TestRail 用戶名
        "TESTRAIL_API_KEY": "YOUR_API_KEY" // 替換為您的 TestRail API 密鑰
      }
    }
  }
}

✨ 主要特性

TestRail MCP 服務器提供了豐富的工具，可用於不同類別的操作，具體如下：

類別	工具名稱
項目	`getProjects`, `getProject`
套件	`getSuites`, `getSuite`, `addSuite`, `updateSuite`
用例	`getCase`, `getCases`, `addCase`, `updateCase`, `deleteCase`, `getCaseTypes`, `getCaseFields`, `copyToSection`, `moveToSection`, `getCaseHistory`, `updateCases`
章節	`getSection`, `getSections`, `addSection`, `moveSection`, `updateSection`, `deleteSection`
運行	`getRuns`, `getRun`, `addRun`, `updateRun`
測試	`getTests`, `getTest`
結果	`getResults`, `getResultsForCase`, `getResultsForRun`, `addResultForCase`, `addResultsForCases`
計劃	`getPlans`
里程碑	`getMilestones`
共享步驟	`getSharedSteps`

🔧 技術細節

故障排除

spawn node ENOENT 錯誤：確保 Node.js 已正確安裝並在 PATH 中。
連接問題：驗證服務器是否正在運行，並且 URL 在 MCP 客戶端中配置正確。
身份驗證問題：檢查您的 TestRail API 憑證在 .env 文件中。
SSE 連接錯誤：如果出現 SSE error: TypeError: fetch failed: connect ECONNREFUSED，請確保服務器正在指定的端口上運行。
對話過長：請使用 limit 和 offset 參數進行測試用例