Lucius MCP

Allure TestOps MCP服务器

Lucius是Allure TestOps的专用模型上下文协议（MCP）服务器，由 FastMCP 和 Starlette.

🎯 动机

诱惑测试操作是一个强大的工具与巨大的API。当你使用人工智能代理来管理你的测试时，它可以很容易地 迷失在细节中或因小技术错误而失败。

Lucius通过提供易于使用且难以破解的AI工具，使这一点变得更加容易：

• 清除工具：每个工具都是为特定任务设计的，比如“查找测试用例”或“更新发布”。
• 有用的错误：如果人工智能出错，Lucius不仅会返回代码，还会提供“代理提示”

准确解释出了什么问题以及如何解决。

• 坚实的基础：我们遵循干净的“精简工具”结构，这意味着逻辑是一致的，对双方来说都很容易

人类和人工智能紧随其后。

🛠️ 支持的工具

🚀 快速开始

1. 安装uv: curl -LsSf https://astral.sh/uv/install.sh | sh
2. 设置凭据：创建一个 .env 使用以下变量保存文件，或使用保存CLI身份验证 lucius auth.
3. 运行服务器: uv run start

基本 .env 快速入门

🔌 Claude桌面集成

在Claude Desktop中使用Lucius的最简单方法是通过 .mcpb 捆绑：

1. 下载最新 lucius-mcp.mcpb 从释放。
2. 使用Claude Desktop打开。
3. 在UI中配置您的Allure凭据。

💻 Claude代码集成

要将Lucius添加到Claude Code，请在项目目录中使用以下命令：

claude mcp add --transport stdio --scope project \
  --env ALLURE_ENDPOINT=https://example.testops.cloud \
  --env ALLURE_PROJECT_ID=123 \
  --env ALLURE_API_TOKEN= \
  --env MCP_MODE=stdio \
  testops-mcp -- uvx --from lucius-mcp --refresh start

项目范围的文本配置示例(.mcp.json):

{
  "mcpServers": {
    "testops-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "lucius-mcp",
        "--refresh",
        "start"
      ],
      "env": {
        "ALLURE_ENDPOINT": "https://example.testops.cloud",
        "ALLURE_PROJECT_ID": "123",
        "ALLURE_API_TOKEN": "",
        "MCP_MODE": "stdio"
      }
    }
  }
}

🧠 食品法典整合

要将Lucius添加到Codex（CLI或IDE扩展），请使用：

codex mcp add testops-mcp \
  --env ALLURE_ENDPOINT=https://example.testops.cloud \
  --env ALLURE_PROJECT_ID=123 \
  --env ALLURE_API_TOKEN= \
  --env MCP_MODE=stdio \
  -- uvx --from lucius-mcp --refresh start

文本配置示例(~/.codex/config.toml 或项目 .codex/config.toml):

[mcp_servers.testops-mcp]
command = "uvx"
args = ["--from", "lucius-mcp", "--refresh", "start"]

[mcp_servers.testops-mcp.env]
ALLURE_ENDPOINT = "https://example.testops.cloud"
ALLURE_PROJECT_ID = "123"
ALLURE_API_TOKEN = ""
MCP_MODE = "stdio"

有关详细设置，包括Claude Desktop（MCPB）集成，请参阅 安装指南.

💻 命令行界面（CLI）

Lucius还提供了一个通用的CLI入口点，用于从命令行直接执行工具：

# List available actions for an entity
uv run lucius test_case

# Execute an action
uv run lucius test_case get --args '{"test_case_id": 1234}'

# Show help for a specific entity/action
uv run lucius test_case get --help

# Save reusable CLI auth
uv run lucius auth --url https://example.testops.cloud --token  --project 123
uv run lucius auth status
uv run lucius auth clear

CLI功能：

• 🎯 带验证的类型安全实体/操作调用
• 🔐 可选的持久CLI身份验证，具有本机每用户配置存储
• 📊 多种输出格式（JSON、表格、csv、纯文本）
• 🔍 每个动作的参数和示例帮助
• 🛡️ 清除错误消息并提供指导
• 📦 Linux、macOS和Windows的独立二进制文件

对于使用Nuitka的本地CLI二进制构建，请使用Python 3.13（构建脚本和CI工作流强制执行此操作）。

CLI身份验证优先级为：

1. 显式工具参数，例如 api_token 或 project_id
2. 环境变量
3. 已从保存CLI身份验证配置 uv run lucius auth
4. 默认值

保存的CLI身份验证使用本机配置位置：

• Linux/Unix： $XDG_CONFIG_HOME/lucius/auth.json 或 ~/.config/lucius/auth.json
• macOS： ~/Library/Application Support/lucius/auth.json 除非明确设置了XDG覆盖
• 窗户： %LOCALAPPDATA%\lucius\auth.json

有关完整的CLI文档和安装说明，请参阅 CLI指南.

📡 遥测

Lucius收集隐私保护使用遥测数据以提高工具质量。默认情况下启用遥测并发送元数据 到 https://stats.ostanin.me，由项目所有者操作的端点（没有第三方可以访问此端点）。

如果这在你的环境中是可以接受的，那么随着时间的推移，保持选择性参与有助于提高Lucius的水平。如果你想退出，设置 TELEMETRY_ENABLED=false 在您的环境中。

不发送API令牌、测试内容或工具参数。

看 遥测和隐私 获取完整的数据字典和遥测行为详细信息。

📂 文档

完整文档可在 docs/ 文件夹：

• 建筑与设计
• 工具参考
• 配置和设置
• 遥测和隐私
• 开发指南
• AI代理协议

🤝 贡献

欢迎投稿！请查看 贡献指南 和 这 开发指南 了解更多详情。