TestRail MCP 服务器

此模型上下文协议 (MCP) 服务器提供了一些工具，用于直接从 Claude AI 和其他支持 MCP 的客户端（如 Cursor）与 TestRail 进行交互。它允许你在不离开与 AI 对话的情况下管理测试用例、项目、套件、运行等。

可用工具

TestRail MCP 服务器提供以下工具：

Related MCP server: TestRail MCP Server

使用方法

你可以通过如下设置连接此 MCP 服务器。此方法使用 npx 自动下载并运行最新版本的包，无需本地安装。

// Example configuration using npx
{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["@bun913/mcp-testrail@latest"],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io", // Replace with your TestRail URL
        "TESTRAIL_USERNAME": "your-email@example.com", // Replace with your TestRail username
        "TESTRAIL_API_KEY": "YOUR_API_KEY" // Replace with your TestRail API key
      }
    }
  }
}

故障排除

• spawn node ENOENT 错误：确保已正确安装 Node.js 并将其添加到 PATH 中。

• 身份验证问题：检查你的 TestRail API 凭据。

• 对话过长：对于测试用例和章节，请使用 limit 和 offset 参数进行分页查询。

• 创建/更新测试用例时出现 HTTP 400 错误：TestRail 项目具有不同的模板、自定义字段和必填字段。此 MCP 服务器直接将你的参数传递给 TestRail API，它不会验证或转换这些参数。如果遇到 400 错误，请在 CLAUDE.md 或 AGENTS.md 中定义项目的规则，以便 LLM 发送正确的参数。例如：

  # TestRail Rules for This Project
  - Project ID: 1
  - Always use template 2 (Separated Steps) when creating test cases
    - Use `customStepsSeparated` (array of step objects)
    - Do NOT send `customSteps` or `customExpected` with template 2
  - Required custom fields: custom_automation_type (default: 0)
  - Call `getCaseFields` at the start of a session to check available fields

贡献

欢迎贡献！请随时提交 Pull Request。

致谢

• TestRail API

• 模型上下文协议 SDK