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, Winsurf, etc.)

Instalación

Instalación mediante herrería

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

Instalación manual

1. Clonar este repositorio:
   git clone https://github.com/yourusername/testrail-mcp.git cd testrail-mcp
2. Crear y activar un entorno virtual:
   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 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.

1. 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
2. Verifique que la configuración se haya cargado correctamente:
   python -c "from testrail_mcp.config import TESTRAIL_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY; print(f'URL: {TESTRAIL_URL}, Username: {TESTRAIL_USERNAME}, API Key: {TESTRAIL_API_KEY[:5]}...')"
   Esto debería imprimir la URL de TestRail, el nombre de usuario y los primeros caracteres de su clave API.

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 como un módulo de Python:

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

1. Abra Claude Desktop
2. Vaya a Configuración > Servidores
3. Haga clic en "Instalar servidor"
4. Navegue hasta el directorio de su proyecto
5. Seleccione el módulo Python: testrail_mcp
6. Claude Desktop ahora podrá usar su servidor TestRail MCP

Cursor

1. Cursor abierto
2. Vaya a Configuración > IA > Herramientas personalizadas
3. Haga clic en "Agregar herramienta"
4. Configurar la herramienta:
   • Nombre: TestRail MCP
   • Comando: python -m testrail_mcp
   • Comunicación: Stdio
5. Guardar la configuración

Winsurf

1. Abrir Winsurf
2. Vaya a Configuración > Herramientas
3. Haga clic en "Agregar herramienta"
4. Configurar la herramienta:
   • Nombre: TestRail MCP
   • Comando: python -m testrail_mcp
   • Protocolo: MCP
5. Guardar la configuración

Pruebas con MCP Inspector

Para realizar pruebas y depuraciones, puede utilizar el Inspector 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)