testomatio/mcp

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

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`)

GitHub에서 전체 README 보기

설치

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"
      }
    }
  }
}