Lucius MCP for Allure TestOps

by ivanostanin

Not rated
GitHub

About

A feature-fich MCP server and CLI for Allure TestOps test management system

Details

Author
ivanostanin
Categories
Developer Tools

Setup

Install Lucius MCP for Allure TestOps in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/ivanostanin/lucius-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

A feature-fich MCP server and CLI for Allure TestOps test management system

Lucius is a specialized Model Context Protocol (MCP) server for Allure TestOps, built withFastMCPandStarlette.

Allure TestOps is a powerful tool with a huge API. When you're using an AI agent to manage your tests, it can easily get lost in the details or fail because of a small technical mistake.

Lucius makes this easier by giving your AI tools that are simple to use and hard to break:

- Clear Tools: Every tool is designed for a specific task, like "finding a test case" or "updating a launch".
- Helpful Errors: If an AI makes a mistake, Lucius doesn't just return a code—it provides an "Agent Hint" that explains exactly what went wrong and how to fix it.
- Solid Foundation: We follow a clean "Thin Tool" structure, meaning the logic is consistent and easy for both humans and AI to follow.

See the full reference inTool Reference.
- Install uv:curl -LsSf https://astral.sh/uv/install.sh | sh
- Setup Credentials: Create a.envfile with the variables below, or save CLI auth withlucius auth.
- Run Server:uv run start

The easiest way to use Lucius in Claude Desktop is via the.mcpbbundle:
- Download the latestlucius-mcp.mcpbfrom Releases.
- Open with Claude Desktop.
- Configure your Allure credentials in the UI.

To add Lucius to Claude Code, use the following command from within your project directory:

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

Project-scoped text config example (.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": "<your_api_token>", "MCP_MODE": "stdio" } } } }

To add Lucius to Codex (CLI or IDE extension), use:

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

Text config example (~/.codex/config.tomlor project.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 = "<your_api_token>" MCP_MODE = "stdio"

For detailed setup, including Claude Desktop (MCPB) integration, seeSetup Guide.

Lucius supports Python 3.10 through 3.14 for runtime use. The generated MCPB manifests and the representative Nuitka CLI compiler matrix validate the same range. Python 3.9 remains unsupported because the pinnedstarlette==1.3.1requires Python 3.10 or newer; Python 3.15 is deferred because the current native dependency set does not build for it.

Lucius also provides a universal CLI entry point for direct tool execution from the command line:

# 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 <your_api_token> --project 123 uv run lucius auth status uv run lucius auth clear

- 🎯 Type-safe entity/action invocation with validation
- 🔐 Optional persistent CLI auth with native per-user config storage
- 📊 Multiple output formats (JSON, table, csv, plain)
- 🔍 Per-action help with parameters and examples
- 🛡️ Clean error messages with guidance
- 📦 Standalone binaries for Linux, macOS, and Windows
- Explicit tool args such asapi_tokenorproject_id
- Environment variables
- Saved CLI auth config fromuv run lucius auth
- Defaults

Saved CLI auth uses native config locations:

- Linux/Unix:$XDG_CONFIG_HOME/lucius/auth.jsonor~/.config/lucius/auth.json
- macOS:~/Library/Application Support/lucius/auth.jsonunless XDG overrides are explicitly set
- Windows:%LOCALAPPDATA%\lucius\auth.json

For full CLI documentation and installation instructions, seeCLI Guide.

Lucius collects privacy-preserving usage telemetry to improve tool quality. Telemetry is enabled by default and sends metadata tohttps://stats.ostanin.me, an endpoint operated by the project owner (no third party has access to this endpoint).

If this is acceptable in your environment, staying opted in helps improve Lucius over time. If you want to opt out, setTELEMETRY_ENABLED=falsein your environment.

No API tokens, test content, or tool arguments are sent.

SeeTelemetry & Privacyfor the full data dictionary and telemetry behavior details.

Full documentation is available in thedocs/folder:

- Architecture & Design
-
Tool Reference
-
Configuration & Setup
-
Telemetry & Privacy
-
Development Guide
-
AI Agent Protocol

Contributions are welcome! Please see theContribution Guidelinesand theDevelopment Guidefor more details.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Create crafted UI components inspired by the best 21st.dev design engineers.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent

ALAPI MCP Tools,Call hundreds of API interfaces via MCP

AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform

MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.

APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.

One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.