Servidor MCP de Testmo

Un servidor de Python Model Context Protocol (MCP) para Testmo: lleva la gestión de pruebas asistida por IA a Claude Desktop, Cursor y cualquier cliente compatible con MCP.

Testmo MCP es un servidor MCP de código abierto que conecta asistentes de IA como Claude Desktop, Claude Code y Cursor directamente a tu instancia de gestión de pruebas de Testmo. Administra casos de prueba, carpetas, hitos, ejecuciones, archivos adjuntos y fuentes de automatización CI/CD, todo mediante lenguaje natural, sin salir de tu cliente de IA.

Creado para ingenieros de QA, SDETs y desarrolladores que usan Testmo y quieren dejar de hacer clic en la interfaz para tareas repetitivas. Impulsado por FastMCP y la API REST de Testmo.

✨ Características

• 🧪 Gestión completa de casos de prueba — crea, lee, actualiza, elimina, busca y realiza operaciones masivas en casos de Testmo

• 📁 Operaciones de carpetas — crea, renombra, mueve, elimina y recorre árboles de carpetas de forma recursiva

• 🚀 Operaciones masivas y por lotes — crea o actualiza hasta 100 casos por llamada, o ilimitados con procesamiento por lotes automático

• 🏃 Ejecuciones de prueba y resultados — lista ejecuciones, obtén detalles de ejecución y filtra resultados de ejecución

• 🎯 Hitos — lista e inspecciona hitos en todos los proyectos

• 📎 Archivos adjuntos — sube, lista y elimina archivos adjuntos en casos de prueba

• 🤖 Fuentes de automatización CI/CD — gestiona ejecuciones de automatización, hilos paralelos y envío de resultados

• 🔗 Integraciones de incidencias — lista conexiones con GitHub, Jira y otras

• 🌳 Ayudantes recursivos — obtén subárboles completos de carpetas de casos en una sola llamada

• 🛠️ Utilidades de mapeo de campos — resuelve IDs de prioridad, tipo y estado sin adivinar

• 🤝 Funciona con cualquier cliente MCP — Claude Desktop, Claude Code, Cursor, Cline y más

🚀 Inicio rápido

Requisitos previos

• Python 3.11 o superior

• Gestor de paquetes uv

• Una instancia de Testmo y una clave API (Configuración → Claves API en Testmo)

• Un cliente compatible con MCP (Claude Desktop, Cursor, etc.)

Instalación

git clone https://github.com/strelec00/testmo-mcp.git
cd testmo-mcp
uv sync

Configuración

Crea un archivo .env en la raíz del proyecto:

TESTMO_URL=https://your-instance.testmo.net
TESTMO_API_KEY=your-api-key

Conectar a Claude Desktop

Añade esto a tu archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "testmo": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/testmo-mcp", "run", "testmo-mcp.py"],
      "env": {
        "TESTMO_URL": "https://your-instance.testmo.net",
        "TESTMO_API_KEY": "your-api-key"
      }
    }
  }
}

Reinicia Claude Desktop. Las herramientas de Testmo aparecerán en la lista de herramientas MCP.

💡 Puedes pasar las credenciales a través de .env o del bloque env anterior; ambos funcionan.

Conectar a Cursor

Abre Configuración de Cursor → MCP (o edita ~/.cursor/mcp.json) y usa el mismo fragmento JSON.

Modo de desarrollo / pruebas

uv run mcp dev testmo-mcp.py

💬 Ejemplos de prompts

Una vez conectado, intenta preguntarle a tu asistente de IA:

• "Lista todos los proyectos en Testmo y muéstrame el llamado Certilligent."

• "Crea 20 casos de prueba de inicio de sesión que cubran credenciales válidas, contraseña incorrecta, cuenta bloqueada, sesión expirada y flujos de 2FA."

• "Busca la carpeta 'Smoke Tests' y lista recursivamente todos los casos de alta prioridad dentro de ella."

• "Actualiza masivamente todos los casos en borrador en la carpeta 42 para establecer su prioridad como alta."

• "Muéstrame la última ejecución de automatización para la fuente Playwright y añade un nuevo hilo de resultados."

• "Sube esta captura de pantalla como archivo adjunto al caso de prueba 1234."

🧠 ¿Por qué usar Testmo con MCP?

Los flujos de trabajo tradicionales de Testmo requieren navegar por la interfaz para cada caso de prueba, cada carpeta, cada actualización masiva. Con Testmo MCP, tu asistente de IA se convierte en un copiloto de QA:

• Crea suites de prueba completas a partir de una especificación de función o PRD en segundos

• Refactoriza estructuras de carpetas de forma conversacional en lugar de clic a clic

• Mantén Testmo sincronizado con tu base de código sin cambiar de contexto

• Combínalo con Claude Code para la automatización de QA de extremo a extremo: genera pruebas de Playwright y regístralas en Testmo

• Conecta ejecuciones de automatización CI/CD directamente desde tu sesión de terminal

🔧 Herramientas disponibles

Proyectos

Carpetas

Casos de prueba

Hitos

Ejecuciones de prueba

Archivos adjuntos

Automatización (CI/CD)

Conexiones de incidencias

Recursivas / compuestas

Utilidad

🛠️ Solución de problemas

"Tool not found" en Claude Desktop Usa una ruta absoluta en args y reinicia completamente Claude Desktop después de editar la configuración.

401 Unauthorized Verifica TESTMO_API_KEY y que la clave tenga el acceso a la API habilitado en Testmo en Configuración → Claves API.

uv: command not found Instala uv: curl -LsSf https://astral.sh/uv/install.sh | sh

🤝 Contribución

Las PR son bienvenidas. Abre un issue primero para cambios mayores.

📄 Licencia

MIT

🔗 Proyectos relacionados

• Testmo — gestión de pruebas unificada para equipos de software

• Model Context Protocol — estándar abierto para integraciones de herramientas de IA

• FastMCP — framework Python para construir servidores MCP

• Claude Desktop — cliente de escritorio de Anthropic con soporte MCP

Palabras clave: testmo mcp, testmo claude, integración ia testmo, servidor mcp testmo, model context protocol testmo, testmo python, cliente api testmo, fastmcp testmo, gestión de pruebas ia, automatización qa claude, testmo cursor, api automatización testmo, creación masiva de casos testmo, servidores mcp anthropic