TestRail MCP 服务器
这个模式上下文协议(MCP)服务器提供了直接从克洛德AI和Cursor等MCP支持的其他客户端与TestRail互动的工具. 它允许你管理测试案例,项目,套房,运行,以及更多不离开你与AI的对话.
可用工具
TestRail MCP 服务器提供了以下工具:
| 类别 | 工具 |
|---|---|
| 项目 | getProjects, (中文(简体) ), getProject |
| 诉讼 | getSuites, (中文(简体) ), getSuite, (中文(简体) ), addSuite, (中文(简体) ), updateSuite |
| 案例 | getCase, (中文(简体) ), getCases, (中文(简体) ), addCase, (中文(简体) ), updateCase, (中文(简体) ), deleteCase, (中文(简体) ), getCaseTypes, (中文(简体) ), getCaseFields, (中文(简体) ), copyToSection, (中文(简体) ), moveToSection, (中文(简体) ), getCaseHistory, (中文(简体) ), updateCases, (中文(简体) ), addBdd, (中文(简体) ), getBdd |
| 节 | getSection, (中文(简体) ), getSections, (中文(简体) ), addSection, (中文(简体) ), moveSection, (中文(简体) ), updateSection, (中文(简体) ), deleteSection |
| 运行 | getRuns, (中文(简体) ), getRun, (中文(简体) ), addRun, (中文(简体) ), updateRun |
| 测试 | getTests, (中文(简体) ), getTest |
| 结果 | getResults, (中文(简体) ), getResultsForCase, (中文(简体) ), getResultsForRun, (中文(简体) ), addResultForCase, (中文(简体) ), addResultsForCases |
| 计划 | getPlans |
| 里程碑 | getMilestones |
| 共同步骤 | getSharedSteps |
使用量
您可以通过如下设置连接 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": "[email protected]", // Replace with your TestRail username
"TESTRAIL_API_KEY": "YOUR_API_KEY" // Replace with your TestRail API key
}
}
}
}
解决问题
-
spawn npx ENOENT编号 :spawn node ENOENT(常见于macOS): 您的 MCP 主机( Cursor, Claude Code, Claude Desktop,...) 找不到npx或者说node在过程发作时。 聊天UI通常将它表面显示为通用"MCP服务器不起作用",没有有用的细节;每个服务器日志是真实性的诊断源.为什么它发生在macOS上: 从 Dock 、 Spotlight 或 Finder 启动的 GUI 应用程序继承了启动的最小值
PATH(单位:千美元)/usr/bin:/bin:/usr/sbin:/sbin) (中文(简体) ). 如果您通过版本管理器安装了节点( N)nvm, (中文(简体) ),asdf, (中文(简体) ),mise, (中文(简体) ),fnm, (中文(简体) ),Volta或 Apple 硅母舰(/opt/homebrew/bin/, (中文(简体) ),npx住在 PATH 之外, 只有您的外壳启动文件( Name~/.zshrc编号 :~/.bashrc)加而为. 您的终端工作是因为 shell 运行了启动文件; GUI- app 进程从未运行过 .诊断 检查每个服务器日志
spawn npx ENOENT数字 :- 光标 :
~/Library/Application Support/Cursor/logs/<session>/window<N>/exthost/anysphere.cursor-mcp/MCP <server>.log - 克洛德代码/克洛德桌面 :
~/Library/Logs/Claude/
修补 替换
"npx"您的 MCP 配置的绝对路径。 运行which npx在正常终端中:/Users/you/.nvm/versions/node/v24.15.0/bin/npx # nvm /opt/homebrew/bin/npx # Apple Silicon Homebrew /usr/local/bin/npx # Intel Homebrew / system Node然后更新您的 MCP 配置 :
{ "mcpServers": { "testrail": { "command": "/Users/you/.nvm/versions/node/v24.15.0/bin/npx", "args": ["@bun913/mcp-testrail@latest"], "env": { "TESTRAIL_URL": "https://your-instance.testrail.io", "TESTRAIL_USERNAME": "[email protected]", "TESTRAIL_API_KEY": "YOUR_API_KEY" } } } }更改后重新启动您的 MCP 客户端 。 同样的固定适用于每个
npx- 发射MCP服务器——如果mcp-testrail是因为这个原因,你另一个npx- 发射服务器也有可能失灵. - 光标 :
-
认证问题:检查您的 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
捐款
欢迎捐款! 请随意提交拉力请求.