Allure Testops MCP Python

Allure TestOps MCP服务器（Python）

Allure TestOps API的模型上下文协议服务器，用Python编写。

概述

此MCP服务器提供了一个Python实现，用于通过模型上下文协议与Allure TestOps API进行交互。它支持测试用例、启动和测试计划的完整CRUD操作，以及56个以上的控制器端点，用于全面的Allure TestOps集成。

安装

先决条件

• Python 3.10或更高版本
• 诗歌包管理器

设置

1. 克隆存储库：

git clone 
cd allure_testops/mcp/python

1. 安装依赖项：

poetry install

1. 设置环境变量（请参阅下面的配置部分）

配置

设置以下环境变量：

• ALLURE_TESTOPS_URL：Allure TestOps实例的基本URL（例如。， https://your-allure-instance.com)
• ALLURE_TOKEN：用于身份验证的API令牌（在Allure TestOps用户设置中生成）
• PROJECT_ID：默认项目ID（数字字符串。， "1")

使用环境变量

export ALLURE_TESTOPS_URL='https://your-allure-instance.com'
export ALLURE_TOKEN='your-api-token'
export PROJECT_ID='1'

使用.env文件（推荐）

创建一个 .env 项目根目录中的文件：

ALLURE_TESTOPS_URL=https://your-allure-instance.com
ALLURE_TOKEN=your-api-token
PROJECT_ID=1

注： 永不承诺 .env 文件到版本控制。使用 .env.example 作为模板。

用法

运行MCP服务器

直接运行服务器：

poetry run python index.py

服务器将在stdio上运行，并通过模型上下文协议进行通信。

独立脚本

存储库包括实用程序脚本：

• get_open_launches.py -从Allure TestOps获取所有打开的发布

poetry run python get_open_launches.py

MCP配置

添加到您的 mcp.json （通常位于 ~/.cursor/mcp.json 或类似）：

{
  "mcpServers": {
    "allure-testops-python": {
      "command": "python3",
      "args": [
        "/absolute/path/to/index.py"
      ],
      "env": {
        "ALLURE_TESTOPS_URL": "https://your-allure-instance.com",
        "ALLURE_TOKEN": "your-api-token",
        "PROJECT_ID": "1"
      }
    }
  }
}

可用工具

测试用例

• list_test_cases -列出项目中的所有测试用例
• get_test_case -按ID获取特定测试用例
• create_test_case -创建新的测试用例
• update_test_case -更新现有测试用例
• delete_test_case -删除测试用例
• bulk_create_test_cases_from_csv -从CSV批量创建测试用例

发射

• list_launches -列出项目中的所有启动
• get_launch -按ID获取特定启动
• create_launch -创建新的发布
• update_launch -更新现有发布
• delete_launch -删除启动
• close_launch -关闭发射

测试计划

• list_test_plans -列出项目中的所有测试计划
• get_test_plan -按ID获取特定的测试计划
• create_test_plan -创建新的测试计划
• update_test_plan -更新现有测试计划
• delete_test_plan -删除测试计划

特性

• ✅ 全面诱惑测试操作API集成
• ✅ 56+控制器端点
• ✅ 异步/等待高性能支持
• ✅ 类型安全工具定义
• ✅ 全面的错误处理
• ✅ CSV导入支持批量操作

项目结构

.
├── index.py                 # Main MCP server entry point
├── allure_client.py         # HTTP client for Allure TestOps API
├── csv_parser.py           # CSV parsing utilities
├── controllers/            # API controller modules
├── get_open_launches.py   # Utility script for fetching open launches
├── pyproject.toml         # Poetry configuration
├── poetry.lock          # Lock file for dependencies
└── README.md              # This file

发展

测试

运行测试脚本：

poetry run python test_simple.py
poetry run python test_mcp.py

看 TESTING.md 和 QUICK_TEST.md 了解更多详情。

安全说明

• 永远不要提交API令牌或凭据 到版本控制
• 使用环境变量或安全密钥管理
• 这 .gitignore 默认情况下，文件不包括敏感文件
• 定期轮换API令牌

贡献

欢迎投稿！请确保：

1. 代码遵循Python最佳实践
2. 所有测试均通过
3. 提交中不包含敏感数据
4. README已更新以获取新功能

许可证

有关详细信息，请参阅LICENSE文件。

支持

对于问题和疑问：

• 查看中的文档 TESTING.md 和 QUICK_TEST.md
• 查看Allure TestOps API文档
• 在存储库中打开问题