MCP Testrail

TestRail MCP服務器提供了與TestRail交互的工具，支持通過Claude AI等MCP客戶端直接管理測試用例、項目、套件和運行等。

開發者工具人工智能聊天機器人 #測試管理 #API集成 #自動化工具 .TypeScript

評分 : 2分

下載量 : 5.7K

更新時間 : 2025-04-28

打開站點

什麼是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 參數進行測試用例