什么是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 参数进行测试用例