testomatio/mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

8 stars 4 forks Качество 74 Тренд 21

Model Context Protocol (MCP) server that enables AI assistants (Claude, Cursor, OpenCode, etc.) to interact with Testomat.io Public API v2.

Обзор

Model Context Protocol (MCP) server that enables AI assistants (Claude, Cursor, OpenCode, etc.) to interact with Testomat.io Public API v2.

README

Показан фрагмент оригинального README. Открыть оригинал.

Testomat.io MCP Server

Model Context Protocol (MCP) server that enables AI assistants (Claude, Cursor, OpenCode, etc.) to interact with Testomat.io Public API v2.

Features

One CLI-style tool per entity - tests, suites, runs, testruns, plans, rungroups, steps, snippets, labels, requirements, branches, tags, milestones, issues; each takes a command argument (list, get, create, update, delete, plus scoped issues_*/attachments_*/share commands where applicable) and flat command params
Project Information - fetch project configuration, metadata, features, and CI profiles
Issue Linking - link/unlink issues to any resource (issues_* commands on each entity, plus the global issues tool)
Attachments - attachments_* commands on tests, suites, and testruns; upload sends a local file path as multipart field files
Requirements - including file uploads from local file paths
API Compatibility - automatic handling of payload format differences (flat vs wrapped)
Automatic API Sessions - groups MCP changes in Testomat.io history using API sessions
Run Management - status transitions via status_event parameter
TQL-Only Search - tests/runs with command: "list" use tql as the single search/filter input
Built-In TQL Reference - TQL parameters include the exact field whitelist and examples; tql_help provides syntax details on demand
Tool Surface Profiles - expose only the tools a session needs via --tools full|core|read (default full); cuts the per-call schema cost for long agentic sessions

Quick Start

Installation

npm install -g @testomatio/mcp@latest

Need enterprise analytics tools? Install @testomatio/mcp-enterprise@latest instead. Details are in the Enterprise Analytics section below.

Configuration

Required credentials:

TESTOMATIO_PROJECT_TOKEN - Your project API token
TESTOMATIO_PROJECT_ID - Your project ID

Run server:

npx testomatio-mcp --token  --project

Or with environment variables:

export TESTOMATIO_PROJECT_TOKEN=
export TESTOMATIO_PROJECT_ID=
npx testomatio-mcp

A bare hostname is expanded to https://. For full control use --base-url / TESTOMATIO_BASE_URL, which takes precedence over the host option

Optional: tool surface profile

By default the server exposes all tools. For long, token-sensitive sessions you can expose a smaller set with --tools:

npx testomatio-mcp --token  --project  --tools core

Profile	What’s exposed
`full` (default)	Everything
`core`	Core entities with all commands (excludes the steps, snippets, labels, rungroups tools)
`read`	Core entities restricted to read-only commands (`list`, `get`, `search`, `issues_list`, `attachments_list`)

Открыть полный README на GitHub

Установка

npx -y @testomatio/mcp@latest --token <TOKEN> --project <PROJECT_ID>

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "testomatio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@testomatio/mcp@latest",
        "--token",
        "<TOKEN>",
        "--project",
        "<PROJECT_ID>"
      ],
      "env": {
        "TESTOMATIO_BASE_URL": "https://app.testomat.io"
      }
    }
  }
}