MCP Testrail

TestRail MCP服务器提供了与TestRail交互的工具，支持通过Claude AI等MCP客户端直接管理测试用例、项目、套件和运行等。

开发者工具人工智能聊天机器人 #测试管理 #API集成 #自动化工具 .TypeScript

评分 : 2分

下载量 : 10.5K

更新时间 : 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 参数进行测试用例