Testrail Mcp Server

Name: Testrail Mcp Server
Author: uarlouski

@uarlouski

关于 Testrail Mcp Server

A high-performance Model Context Protocol (MCP) server connecting AI assistants (Claude, Cursor, Windsurf) directly to TestRail.

#testrail-mcp-server #model-context-protocol #testrail-api-integration #ai-test-management #llm-testing-tools #claude-testrail-plugin #cursor-testrail #windsurf-qa-tool #test-case-automation #qa-ai-assistant #mcp-server-developer-tools #prompt-engineering-testrail #test-run-tracking #qa-productivity-automation

基本信息

分类

其他

传输方式

stdio

发布者

uarlouski

提交者

Uladzislau Arlouski

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server@latest"
      ],
      "env": {
        "TESTRAIL_INSTANCE_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "[email protected]",
        "TESTRAIL_API_KEY": "your-api-key"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is TestRail MCP Server?

TestRail MCP Server is a high-performance Model Context Protocol (MCP) server that connects AI assistants (such as Claude, Cursor, and Windsurf) directly to TestRail. It enables users to search, create, update, and execute test cases using natural language, eliminating manual copy-pasting and context switching.

How to use TestRail MCP Server?

Obtain a TestRail API key from My Settings → API Keys. Then add the server to your MCP client configuration (e.g., Claude Desktop, Cursor, Windsurf) by providing the npx command and the three required environment variables: TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, and TESTRAIL_API_KEY. Once configured, you can instruct your AI assistant to perform TestRail operations in natural language.

Key features of TestRail MCP Server

Intelligent discovery of projects, suites, and sections.
Full test case management with custom field support.
Actionable test execution and result tracking.
Context-aware AI that exposes templates, fields, and statuses.
Bulk edit and attachment capabilities for runs.

Use cases of TestRail MCP Server

List all active projects to find the latest one.
Show test cases from a specific section of a project.
Create a comprehensive test case with detailed steps.
Start a new test run containing selected cases.
Mark a test case as passed with a comment.

FAQ from TestRail MCP Server

What is TestRail MCP Server and how does it differ from manual TestRail usage?

It is an MCP server that lets AI assistants interact with TestRail via natural language, automating test management tasks that otherwise require manual navigation and copy-pasting.

How do I install and configure TestRail MCP Server?

Installation is done by adding the server to your MCP client configuration using the npx command with the @uarlouski/testrail-mcp-server@latest package. You must set three environment variables: your TestRail instance URL, your user email, and your API key.

Which AI assistants or MCP clients are supported?

The server works with any MCP-compliant client, including Claude Desktop, Cursor, and Windsurf.

What TestRail operations can I perform through this server?

You can list projects and sections, create/update/bulk-edit test cases, add test runs, submit results by test ID or case ID, attach files to runs, and retrieve metadata like statuses, priorities, case fields, and templates.