TestRail

Interactúa con las entidades principales de TestRail, como casos de prueba, ejecuciones y resultados, utilizando un protocolo estandarizado.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de TestRail

Un servidor de Model Context Protocol (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
- Ejecuciones
- Resultados
- Conjuntos de datos
Soporte completo para el Model Context Protocol
Compatible con cualquier cliente MCP (Claude Desktop, Cursor, Windsurf, etc.)

Véalo en acción junto con Octomind MCP

Instalación

Instalación mediante Smithery

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

Clone este repositorio:

git clone https://github.com/yourusername/testrail-mcp.git
cd testrail-mcp

Cree y active un entorno virtual:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Instale las dependencias:
```
pip install -e .
```

Configuración

El servidor MCP de TestRail requiere variables de entorno específicas para autenticarse con su instancia de TestRail. Estas deben establecerse 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 de API de TestRail (no su contraseña)
  - Para generar una clave de API, inicie sesión en TestRail, vaya a "Mi configuración" > "Claves de 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 de API para verificación.

Si está utilizando 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 establecer estas variables en el entorno de su sistema o asegurarse de que se carguen desde el archivo .env.

Uso

Ejecutar el servidor

El servidor se puede ejecutar directamente usando el script instalado:

uvx testrail-mcp

Esto iniciará el servidor MCP en modo stdio, que se puede usar con clientes MCP que admitan comunicación stdio.

Uso con clientes MCP

Claude Desktop

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 pruebas y depuración, puede usar MCP Inspector:

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á explorar y probar todas las herramientas y recursos disponibles.

Desarrollo

Este servidor está construido usando:

FastMCP - Un framework de Python para construir servidores MCP
Requests - Para comunicación HTTP con la API de TestRail
python-dotenv - Para la gestión de variables de entorno

Licencia

MIT