TestRail集成扩展

该扩展连接Goose与TestRail,允许Goose直接从TestRail实例获取测试运行、测试结果和状态,消除手动更新并简化QA自动化流程。

  • by Purneema-rathod
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Purneema-rathod/mcp-testrail-extension-uv

使用说明

🧩 鹅试验轨道延伸

此扩展连接 鹅 随着 TestRail,允许Goose直接从您的TestRail实例中获取测试运行、测试结果和状态,从而消除了手动更新并简化了QA自动化。


⚙️ 1.先决条件

🪟 视窗

  • python ≥3.12.2(推荐)
    👉 点击此处下载
  • 紫外线 (轻量级Python包管理器)
    pip install uv
    
  • Git 已安装并添加到PATH
    👉 下载Git

🍎 macOS

  • python ≥3.12.2(通过 pyenv 或 家酿)
    brew install python@3.12
    
  • 紫外线 全球安装
    pip install uv
    
  • Goose的全磁盘访问
    (系统设置→ 隐私和安全→ 全磁盘访问→ 启用终端/鹅)

📦 2.设置说明

  1. 提取ZIP
    解压缩 mcp-testrail-final-26thMay2025.zip 进入首选位置,例如:

    /Users/<username>/Downloads/mcp-testrail-final-26thMay2025/
    
  2. 创建虚拟环境
    在终端(或命令提示符)中,导航到提取的文件夹并运行:

    uv sync
    

    这将安装所有必需的依赖项并创建 .venv 与Goose兼容的环境。

  3. 设置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
质量工程|块