# Allure TestOps MCP

Standalone stdio MCP server for Allure TestOps test case operations.

## Tools

- `testops_search_test_cases`
- `testops_get_test_case`
- `testops_create_test_case`
- `testops_delete_test_case`
- `testops_get_scenario`
- `testops_update_scenario`
- `testops_get_issues`
- `testops_set_issues`
- `testops_get_custom_fields`
- `testops_set_custom_fields`

## Configuration

Environment variables:

```bash
TESTOPS_BASE_URL=https://testops.example.com
TESTOPS_TOKEN=your-api-token
TESTOPS_REQUEST_TIMEOUT_MS=30000
TESTOPS_JIRA_INTEGRATION_ID=1
TESTOPS_ARTIFACTS_DIR=./artifacts
```

`TESTOPS_ARTIFACTS_DIR` is optional. If it is set, every tool response is also written to a timestamped JSON artifact.

## Run Locally

```bash
npm install
npm test
TESTOPS_BASE_URL=https://testops.example.com TESTOPS_TOKEN=... npm start
```

## Cursor

Project-level `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "testops": {
      "command": "node",
      "args": ["/absolute/path/to/allure-testops-mcp/src/mcp-server.js"],
      "env": {
        "TESTOPS_BASE_URL": "https://testops.example.com",
        "TESTOPS_TOKEN": "your-api-token"
      }
    }
  }
}
```

If the package is published to npm:

```json
{
  "mcpServers": {
    "testops": {
      "command": "npx",
      "args": ["-y", "allure-testops-mcp"],
      "env": {
        "TESTOPS_BASE_URL": "https://testops.example.com",
        "TESTOPS_TOKEN": "your-api-token"
      }
    }
  }
}
```

## Codex

```toml
[mcp_servers.testops]
command = "node"
args = ["/absolute/path/to/allure-testops-mcp/src/mcp-server.js"]

[mcp_servers.testops.env]
TESTOPS_BASE_URL = "https://testops.example.com"
TESTOPS_TOKEN = "your-api-token"
```

## Claude

```json
{
  "mcpServers": {
    "testops": {
      "command": "node",
      "args": ["/absolute/path/to/allure-testops-mcp/src/mcp-server.js"],
      "env": {
        "TESTOPS_BASE_URL": "https://testops.example.com",
        "TESTOPS_TOKEN": "your-api-token"
      }
    }
  }
}
```