Servidor MCP de TestRail

Un servidor de Protocolo de Contexto de Modelo (MCP) para TestRail que permite la interacción con las entidades principales de TestRail a través de un protocolo estandarizado.

Características

Autenticación con la API de TestRail
Acceso a las entidades de TestRail:
- Proyectos
- Casos
- Carreras
- Resultados
- Conjuntos de datos
Soporte completo para el Protocolo de Contexto de Modelo
Compatible con cualquier cliente MCP (Claude Desktop, Cursor, Windsurf, etc.)

Véalo en acción junto con Octomind MCP

Instalación

Instalación mediante herrería

Para instalar testrail-mcp para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @sker65/testrail-mcp --client claude

Instalación manual

Clonar este repositorio:
git clone https://github.com/yourusername/testrail-mcp.git cd testrail-mcp
Crear y activar un entorno virtual:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
Instalar dependencias:
pip install -e .

Configuración

El servidor TestRail MCP requiere variables de entorno específicas para autenticarse con su instancia de TestRail. Estas deben configurarse antes de ejecutar el servidor.

Cree un archivo .env en el directorio raíz del proyecto:
TESTRAIL_URL=https://your-instance.testrail.io TESTRAIL_USERNAME=your-email@example.com TESTRAIL_API_KEY=your-api-key
Notas importantes:
- TESTRAIL_URL debe ser la URL completa de su instancia de TestRail (por ejemplo, https://example.testrail.io )
- TESTRAIL_USERNAME es su dirección de correo electrónico de TestRail utilizada para iniciar sesión
- TESTRAIL_API_KEY es su clave API de TestRail (no su contraseña)
  - Para generar una clave API, inicie sesión en TestRail, vaya a "Mi configuración" > "Claves API" y cree una nueva clave
Verifique que la configuración se haya cargado correctamente:
uvx testrail-mcp --config
Esto mostrará la información de configuración de TestRail, incluida su URL, nombre de usuario y los primeros caracteres de su clave API para verificación.

Si utiliza este servidor con un cliente como Claude Desktop o Cursor, asegúrese de que las variables de entorno sean accesibles para el proceso que ejecuta el servidor. Es posible que deba configurar estas variables en el entorno de su sistema o asegurarse de que se carguen desde el archivo .env .

Uso

Ejecución del servidor

El servidor se puede ejecutar directamente utilizando el script instalado:

uvx testrail-mcp

Esto iniciará el servidor MCP en modo stdio, que se puede utilizar con clientes MCP que admiten la comunicación stdio.

Uso con clientes MCP

Escritorio de Claude

En Claude Desktop, agregue un nuevo servidor con la siguiente configuración:

{
  "mcpServers": {
    "testrail": {
      "command": "uvx",
      "args": [
        "testrail-mcp"
      ],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "your-email@example.com",
        "TESTRAIL_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

En Cursor, agregue una nueva herramienta personalizada con la siguiente configuración:

{
  "name": "TestRail MCP",
  "command": "uvx",
  "args": [
    "testrail-mcp"
  ],
  "env": {
    "TESTRAIL_URL": "https://your-instance.testrail.io",
    "TESTRAIL_USERNAME": "your-email@example.com",
    "TESTRAIL_API_KEY": "your-api-key"
  }
}

Windsurf

En Windsurf, agregue una nueva herramienta con la siguiente configuración:

{
  "name": "TestRail MCP",
  "command": "uvx",
  "args": [
    "testrail-mcp"
  ],
  "env": {
    "TESTRAIL_URL": "https://your-instance.testrail.io",
    "TESTRAIL_USERNAME": "your-email@example.com",
    "TESTRAIL_API_KEY": "your-api-key"
  }
}

Pruebas con MCP Inspector

Para realizar pruebas y depuraciones, puede utilizar el Inspector MCP:

npx @modelcontextprotocol/inspector \
  -e TESTRAIL_URL=<your-url> \
  -e TESTRAIL_USERNAME=<your-username> \
  -e TESTRAIL_API_KEY=<your-api-key> \
  uvx testrail-mcp

Esto abrirá una interfaz web donde podrás explorar y probar todas las herramientas y recursos disponibles.

Desarrollo

Este servidor está construido utilizando:

FastMCP : un marco de Python para crear servidores MCP
Solicitudes : para la comunicación HTTP con la API de TestRail
python-dotenv - Para la gestión de variables de entorno

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de protocolo de contexto de modelo que permite la interacción con las entidades centrales de TestRail (proyectos, casos, ejecuciones, resultados, conjuntos de datos) a través de un protocolo estandarizado compatible con clientes MCP como Claude Desktop.

Related MCP Servers

Qase MCP Server
RayYokoyama
-
security
F
license
-
quality
A Model Context Protocol server that integrates with the Qase test management platform, allowing users to create and retrieve test cases, manage test runs, and interact with Qase projects.
Last updated -
3
1
JavaScript
JMeter MCP Server
Narasimhakatta
A
security
F
license
A
quality
A Model Context Protocol server that enables executing and interacting with JMeter tests through MCP-compatible clients like Claude Desktop, Cursor, and Windsurf.
Last updated -
2
Python
MCP Test Server
small-tou
A
security
F
license
A
quality
A testing server that demonstrates Model Context Protocol features, providing access to user data, todos, and system information through resources, tools for user management and calculations, and prompt templates for various analyses.
Last updated -
4
TypeScript
MCP Test Server
dannyhertz
-
security
F
license
-
quality
A simple server for testing Model Context Protocol (MCP) that serves CSV and image resources, allowing developers to test MCP implementations with sample data via SSE transport.
Last updated -
9
JavaScript

View all related MCP servers

TestRail MCP Server