testrail-mcp-server

概述

TestRail MCP Server 是一个专用集成，使 Claude、Cursor 和 Windsurf 等 AI 助手能够直接与 TestRail 测试管理平台交互。它提供了全面的功能，包括浏览项目、管理测试用例、创建测试运行和记录结果—all 都通过对话式 AI 交互实现。该服务器具有为 LLM 用例专门设计的强类型模式，确保结构化数据生成和验证。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• get_projects

  List all available active and completed projects in your TestRail instance

  试试:List all projects in TestRail to find the latest active project试试:Show me all projects in our TestRail instance
• get_sections

  Navigate the precise folder/section hierarchy of any test suite

  试试:Show me the section hierarchy for project 3试试:List all sections in test suite 5
• get_cases

  Query test cases with advanced filtering and pagination

  试试:Show me all test cases in section 5 of project 3试试:Find test cases with high priority that haven't been run
• get_case

  Fetch complete details of a specific test case

  试试:Get details for test case ID 1042试试:Show me the complete test case with case ID 56
• add_case

  Create a new test case with custom field validation

  试试:Create a comprehensive test case for 'Login Validation' with detailed steps试试:Add a new test case for the checkout process
• update_case

  Modify an existing test case's steps or metadata

  试试:Update test case 1042 to add a new precondition试试:Change the title of test case 56 to 'Login with valid credentials'
• update_cases

  Bulk-update multiple test cases simultaneously

  试试:Mark test cases 10, 11, and 12 as obsolete试试:Set the priority to high for all test cases in section 5
• add_run

  Generate a new focused test run in TestRail

  试试:Start a new test run containing cases from section 5试试:Create a regression test run for version 2.3
• get_tests

  Retrieve individual tests for a specific run with status filtering

  试试:Show me all tests in run 23试试:List only the failed tests from the last regression run
• add_results

  Submit test results to a test run using the specific test ID

  试试:Mark test ID 45 as passed with the comment 'Tested successfully'试试:Record that test ID 78 failed with attachment log.txt
• add_results_for_cases

  Submit results to a run mapping directly to case IDs

  试试:Mark test case 1042 as passed for the current run试试:Record failed results for cases 10, 11, and 12
• add_attachment_to_run

  Attach logs, files, or artifacts directly to a test run

  试试:Add screenshot.png to the current test run试试:Attach the test log file to run 23

可对比工具

安装

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["-y", "@uarlouski/testrail-mcp-server@latest"],
      "env": {
        "TESTRAIL_INSTANCE_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "your@email.com",
        "TESTRAIL_API_KEY": "your-api-key",
        "TESTRAIL_ENABLE_SHARED_STEPS": "true"
      }
    }
  }
}

FAQ

哪些 AI 助手与此 MCP 服务器兼容？

TestRail MCP Server 适用于 Claude Desktop、Cursor、Windsurf 以及任何其他符合 MCP 的 AI 助手。

TestRail 需要哪种身份验证方法？

您需要在 MCP 配置中通过环境变量提供您的 TestRail 实例 URL、用户名和 API 密钥。

testrail-mcp-server 对比