@m00nsolutions/mcp-server

Gestión agéntica de pruebas a través de MCP. Este servidor permite que un asistente de IA haga el trabajo en lugar de leer sobre él: crear casos de prueba, planificar y completar ejecuciones de pruebas manuales, vincular la automatización con los casos que cubre, publicar versiones y consultar el estado del proyecto en M00N Report, una plataforma de gestión de pruebas nativa de IA.

¿Qué instalación necesito?

Si no te conectas desde claude.ai o claude.com, usa este paquete con una clave MCP. Eso es el resto de este README. Para el conector, consulta la guía del conector.

Related MCP server: @testneo/mcp-server

Requisitos

Node 20 o superior, y cualquier cliente compatible con MCP.

Instalación

No hay paso de instalación. El cliente lo inicia con npx, como se configura a continuación.

Para fijar una versión en un entorno compartido o de CI, añade una versión al nombre del paquete en args, por ejemplo ["-y", "@m00nsolutions/mcp-server@<version>"]. npm view @m00nsolutions/mcp-server versions lista lo que está publicado. A propósito, se usa un marcador de posición en lugar de un número: un ejemplo concreto aquí queda desactualizado en la próxima versión, y uno desactualizado recomiaría fijar una versión que ya no tiene las correcciones actuales.

Inicio rápido

1. Obtén una clave MCP

En M00N Report, abre Configuración -> Claves MCP y crea una clave. Empieza por m00n_mcp_, seguida de 48 caracteres hexadecimales. Esta no es la credencial que usan los informadores de pruebas; la suya empieza por m00n_ y aquí se rechaza.

Una clave MCP tiene exactamente los permisos de la cuenta a la que pertenece, nunca más, y se puede limitar aún más. Limitar reduces el número de herramientas en la lista que ve el cliente, de modo que una lista más corta de lo esperado es una decisión de alcance, no un error.

La clave va en la configuración de tu propio cliente MCP en tu máquina. No la pongas en un archivo del espacio de trabajo que esté alojado en un repositorio.

2. Conecta tu cliente

Claude Code, una línea:

claude mcp add m00n --env M00N_API_URL=https://m00nreport.com --env M00N_API_KEY=m00n_mcp_... -- npx -y @m00nsolutions/mcp-server

Los demás clientes usan el mismo bloque JSON:

{
  "mcpServers": {
    "m00n": {
      "command": "npx",
      "args": ["-y", "@m00nsolutions/mcp-server"],
      "env": {
        "M00N_API_URL": "https://m00nreport.com",
        "M00N_API_KEY": "m00n_mcp_your_key_here"
      }
    }
  }
}

Dónde va ese bloque:

Para una instancia autoalojada, apunta M00N_API_URL a tu propio origen raíz, sin el sufijo /api. La barra final se elimina por ti.

3. Confirma la conexión

Reinicia el cliente y luego pídele:

Lista mis proyectos de M00N Report

Una lista de tus proyectos significa que el servidor está conectado y la clave es válida. Un error, o que el asistente diga que no dispone de esa herramienta, significa que no está; consulta la Solución de problemas.

Herramientas

Ocho áreas. La lista completa con argumentos está en /documentation/mcp/tools, mantenida junto al código. El servidor obtiene su propia lista de tu instancia al iniciarse, así que lo que tu cliente ve es lo que tu instancia admitía cuando el cliente se conectó.

Una ejecución es una ejecución de pruebas manuales: responsables, entorno, fechas y anotación de resultados por pasocapturados contra una instantánea de cada caso en el momento en que se añadió.

Cuántas herramientas puede ver tu clave depende de tu instancia:

curl -s -H "X-MCP-Key: $M00N_API_KEY" "$M00N_API_URL/api/mcp/tools" | jq .count

Eso devolvió 57 en m00nreport.com con una clave sin restricir el 22 de agosto de 2026.

Prompts

Flujos de trabajo guiados y en varios pasos que el cliente puede ofrecer por nombre. Cada uno acepta un único argumento opcional project, un nombre o un UUID; si se omite, el servidor elige el proyecto cuando solo hay uno en el alcance.

Recursos

Vistas de solo lectura que el cliente puede lanzar sin llamar a una herramienta: todos los proyectos, resumen de estado del proyecto, informe de pruebas intermitentes, pruebas que fallan actualmente, estructura de carpetas, informe de lanzamiento, contenido de casos de prueba, resumen de versiones.

Configuración

Los dos valores booleanos se activan con true, 1 o yes, en cualquier combinación de mayúsculas/minúsculas. Cualquier otro valor, {incluidos false y 0, los deja desactivados.

Establece both primeras o ninguna. Establecer solo una se trata como un error y se rechaza, porque un servidor a medio configurar que se inicia igualmente es más difícil de diagnosticar que uno que no comienza.

La base URL es M00N_API_URL aquí; los informadores de pruebas llaman a la misma URL M00N_SERVER_URL. Los seis paquetes leen M00N_API_KEY, pero la de ellos es una clave de API de proyecto, no una clave MCP, por lo que una única variable de shell exportada no puede servir para ambos.

Ejecución sin clave

Si se inicia sin M00N_API_URL ni con regular M00N_API_KEY, el servidor se ejecuta en modo preview: exhibe sus herramientas, promts y recursos de una instantánea integrada y rechaza cualquier petición con un mensaje diciendo qué hay que configurar. No se envía nada a ninguna parte, porque no hay un destino donde enviarlo.

Eso permite que un inspector, un cliente o un irectory muestre la superficie de herramientas antes de que nadie se haya registrado. Es una descripción del servidor, nunca una de trabajo, por lo que los listados proceden de la instantánea y no de tu instancia: una clave acotada normalmente muestra menos herramientas que la instantánea.

Los mantenedores actualizan la instantánea con npm run snapshot:refresh contra una clave no acotada.

Autoalojado

ApuntaM00N_API_URL a tu propia instancia y usa una clave MCP emitida desde esa instancia. Todo lo demás es idéntico, lo que importa cuando la razón por la que autohospedas es que los datos de prueba no pueden salir de tu red.

Con un certificado autofirmado, añade "M00N_INSECURE_SSL": "true" al mismo bloque env. Notas completas: /documentation/mcp/self-hosted.

Qué se envía

A M00N_API_URL a través de HTTPS: las llamadas a herramientas que hace tu asistente y sus argumentos. El servidor es un proxy hacia tu propia instancia y no almacena nada por sí mismo.

Cada llamada a una herramienta se escribe en un registro de auditoría de MCP con una interfaz en la aplicación, y los límites de frecuencia por clave frenalkeen a un agente sin control. La clave nunca se escribe en ese registro, ni en stderr. Con M00N_DEbug, los argumentos de cada llamada a una herramienta se imprimen en stderr, así que trata esa salida como quieras los datos propios.

Solución de problemas

El servidor envía sus registros a stderr con o sin M00N_DEBUG, y la mayoría de los clientes los muestran en su panel MCP. Establece M00N_DEBUG en true para añadir cada solicitud y sus argumentos.

Limitaciones conocidas

• La lista de herramientas se lee una sola vez, al arranque. Si cambias el ámbito de una clave o actualizas la instancia, el cliente mantiene la lista antigua hasta que reinicies el cliente.

• GET /api/health debe ser alcanzable cuando está configurado. Se comprueba antes que cualquier otra cosa y un fallo detiene el servidor, así que un proxy que solo reenvíe /api/mcp/* no muestra ninguna herramienta, aunque todas funcionarían.

• Una clave con ámbito de afecta herramientas no arranca. El servidor termina en lugar de conectarse con una lista vacía. Este es el camino configurado; sin credenciales en absoluto se inicia en modo de vista previa.

• Los prompts y los recursos son opcionales. Si fallan sus listados, el servidor igual se inicia, con el motivo en stderr, y el cliente no ve ninguno de ellos durante toda la sesión.

• Las redirecciones se rechazan, no se siguen. La clave viaja en una cabecera personalizada, y los seguidores de redirecciones solo eliminan las cabeceras de autenticación que reconocen, así que seguir una entregaría la clave al host que respondiera a continuación. Una redirección se informa con la dirección a la que apuntaba.

• Solo stdio. Para un transporte por HTTP, usa el conector alojado.

Soporte

• Package en npm

• Documentación

• Informar de problemas

• Discord de la comunidad

Licencia

Licencia MIT. Consulta LICENSE.