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)

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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

Calculator MCP Server
QuantGeekDev
-
security
F
license
-
quality
A Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.
Last updated -
48
4
TypeScript
MCP Maker
CaptainCrouton89
-
security
-
license
-
quality
A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
Last updated -
1
TypeScript
mcp-framework-starter
QuantGeekDev
-
security
F
license
-
quality
A starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.
Last updated -
TypeScript
Echo MCP Server
piebro
A
security
A
license
A
quality
A simple server implementing the Model Context Protocol (MCP) that echoes messages back, designed for testing MCP clients.
Last updated -
1
Python
MIT License

View all related MCP servers

TestRail MCP Server