testomatio/mcp

API 开发

本页由 AI 翻译，技术细节请以原文为准。查看原文

8 stars 4 forks 质量 74 趋势 21

Repository Install

testomatio/mcp 是从 https://github.com/testomatio/mcp. 导入的 MCP 服务器候选

概览

testomatio/mcp 是从 https://github.com/testomatio/mcp. 导入的 MCP 服务器候选

概述（AI 翻译）

模型上下文协议（MCP）服务器，使AI助手（Claude、Cursor、OpenCode等）能够与 Testomat.io Public API v2交互。

特色

每个实体一个CLI风格工具 - tests、suites、runs、testruns、plans、rungroups、steps、snippets、labels、requirements、branches、tags、milestones、issues];每个变量可接受command参数（list、get、create、update、delete，以及适用时的issues_*/attachments_*/share）命令和平面命令参数
项目信息 - 获取项目配置、元数据、特征和配置配置档
问题链接 - 将问题链接/取消关联到任意资源（每个实体的issues_*命令，以及全局issues工具）
附件- attachments_*在测试、套件和测试运行中的命令;上传时以多部分字段[[T26]形式发送本地文件路径]
需求——包括从本地文件路径上传的文件
API 兼容性 - 自动处理有效载荷格式差异（扁平与封装）
自动API会话 - 利用API会话分组MCP历史中的变更 Testomat.io
运行管理 - 通过status_event参数进行状态切换

本页由 AI 翻译，技术细节请以原文为准。

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>

新手？先看 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"
      }
    }
  }
}