Testrail MCP

TestRail MCP服務器是一個基於Model Context Protocol的接口服務，實現了與TestRail測試管理系統的標準化交互。

開發者工具人工智能聊天機器人 #測試管理 #協議服務 #API集成 .Python

評分 : 2.5分

下載量 : 12

更新時間 : 2025-04-28

什麼是TestRail MCP Server?

TestRail MCP Server是一個基於Model Context Protocol（MCP）的中間件服務，它允許您通過自然語言或標準化命令與TestRail測試管理系統進行交互。該服務將複雜的API調用簡化為直觀的操作指令，特別適合需要頻繁查看和管理測試用例、測試結果的測試人員和開發人員。

如何使用TestRail MCP Server?

您可以通過安裝MCP客戶端（如Claude Desktop、Cursor或Windsurf）連接到本服務。連接後，您可以直接查詢測試項目狀態、查看測試用例或提交測試結果，就像與智能助手對話一樣簡單。

適用場景

1. 快速查詢測試進度 2. 批量查看測試用例 3. 自動化測試結果提交 4. 與CI/CD流程集成 5. 測試數據分析與報告生成

主要功能

TestRail認證集成支持通過API密鑰安全連接到您的TestRail實例

完整實體訪問可以操作Projects(項目)、Cases(用例)、Runs(運行)、Results(結果)等核心測試管理對象

完整MCP協議支持兼容所有標準MCP客戶端，提供一致的交互體驗

測試數據集管理支持創建和管理測試數據集，便於參數化測試

優勢與侷限性

優勢

無需記憶複雜API，使用自然語言即可操作TestRail

與多種MCP客戶端兼容，選擇靈活

簡化測試管理流程，提升工作效率

支持自動化腳本集成

侷限性

需要TestRail企業版或雲版支持

首次配置需要API密鑰

部分高級功能需要TestRail特定權限

如何使用

安裝服務

可以通過Smithery一鍵安裝或手動安裝

配置連接

設置TestRail實例URL和API密鑰

啟動服務

運行服務並連接到MCP客戶端

客戶端配置

在您喜歡的MCP客戶端中添加服務器配置

使用案例

查詢測試進度每日站會前快速查看各測試項目的完成情況

批量更新測試結果自動化測試完成後批量提交結果

測試用例搜索快速定位特定功能的測試用例

常見問題

如何獲取TestRail API密鑰？

支持哪些MCP客戶端？

服務無法啟動怎麼辦？

能否同時連接多個TestRail實例？

🚀 TestRail MCP 服務器

一個用於 TestRail 的 Model Context Protocol (MCP) 服務器，藉助標準化協議達成與 TestRail 核心實體的交互，有效提升與 TestRail 系統的交互效率。

🚀 快速開始

TestRail MCP 服務器可助力您通過標準化協議與 TestRail 核心實體交互。下面為您介紹安裝、配置及使用的步驟。

✨ 主要特性

支持與 TestRail API 的身份驗證，保障數據交互安全。
可訪問多種 TestRail 實體，涵蓋項目、用例、運行、結果、數據集。
完全支持 Model Context Protocol (MCP)，確保協議兼容性。
能與任何 MCP 客戶端兼容，如 Claude Desktop、Cursor、Windsurf 等。

🎥 視頻演示

點擊下方圖片觀看視頻演示：

📦 安裝指南

通過 Smithery 安裝

若要為 Claude Desktop 自動安裝 testrail - mcp，可使用 Smithery：

npx -y @smithery/cli install @sker65/testrail-mcp --client claude

手動安裝

克隆此倉庫：

git clone https://github.com/yourusername/testrail-mcp.git
cd testrail-mcp

創建並激活虛擬環境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

安裝依賴項：

pip install -e .

⚙️ 配置

TestRail MCP 服務器需特定環境變量以與您的 TestRail 實例進行身份驗證，運行服務器前必須設置這些變量。

在項目根目錄中創建一個 .env 文件：

TESTRAIL_URL=https://your-instance.testrail.io
TESTRAIL_USERNAME=your-email@example.com
TESTRAIL_API_KEY=your-api-key

注意：請確保將 <your-url>、<your-username> 和 <your-api-key> 替換為實際的值。 2. 完成配置後，您可以運行服務器：

uvicorn main:app --reload

💻 使用示例

測試與調試

對於測試和調試，您可以使用 MCP Inspector：

npx @modelcontextprotocol/inspector \
  -e TESTRAIL_URL=<your-url> \
  -e TESTRAIL_USERNAME=<your-username> \
  -e TESTRAIL_API_KEY=<your-api-key> \
  uvx testrail-mcp

這將打開一個 Web 界面，您可以在其中探索和測試所有可用工具和資源。