使用说明
🧩 鹅试验轨道延伸
此扩展连接 鹅 随着 TestRail,允许Goose直接从您的TestRail实例中获取测试运行、测试结果和状态,从而消除了手动更新并简化了QA自动化。
⚙️ 1.先决条件
🪟 视窗
🍎 macOS
- python ≥3.12.2(通过 pyenv 或 家酿)
brew install python@3.12 - 紫外线 全球安装
pip install uv - Goose的全磁盘访问
(系统设置→ 隐私和安全→ 全磁盘访问→ 启用终端/鹅)
📦 2.设置说明
-
提取ZIP
解压缩mcp-testrail-final-26thMay2025.zip进入首选位置,例如:/Users/<username>/Downloads/mcp-testrail-final-26thMay2025/ -
创建虚拟环境
在终端(或命令提示符)中,导航到提取的文件夹并运行:uv sync这将安装所有必需的依赖项并创建
.venv与Goose兼容的环境。 -
设置TestRail凭据(无需手动
.env需要文件)
在同一目录中运行此命令:echo -e "TESTRAIL_URL=https://afterpay.testrail.io\nTESTRAIL_USER=your-email@example.com\nTESTRAIL_API_KEY=your-api-key" > .env✅ 这会自动创建一个
.env文件中包含您的TestRail凭据。
🦢 3.在Goose中启用扩展
打开 鹅→ 设置→ 扩展→ 新增,然后填写以下字段:
| 领域 | 价值 |
|---|---|
| 名字 | 试验轨道 |
| 描述 | 试验轨道工具 |
| 类型 | 标准IO |
| 命令 | uv run /full/path/to/.venv/bin/<folder-name> |
💻 示例(macOS)
uv run /Users/purneema/Downloads/mcp-testrail-final-26thMay2025/.venv/bin/mcp-testrail-final-26thMay2025
🪟 示例(Windows)
uv run C:\Users\<YourName>\Downloads\mcp-testrail-final-26thMay2025\.venv\Scripts\mcp-testrail-final-26thMay2025.exe
⚠️ 确保路径与系统上提取的文件夹名称和位置匹配。
✅ 4.验证安装
启用后,重新启动Goose。
您可以通过在Goose中运行以下命令来测试您的设置:
/testrail get_test_runs
如果配置正确,您将看到从实例中检索到的TestRail运行列表。
🧠 备注
- 保持
.venv与扩展名位于同一目录中的文件夹。 - 使用你的 实际TestRail URL (例如。,
https://afterpay.testrail.io). - 如果Goose无法检测到扩展名,请检查您的 命令 路径。
- 重新运行
uv sync如果你更新依赖关系或Python版本。
👩💻 作者
Purneema Suresh Rathod
质量工程|块
