testlink-mcp

Un servidor de Model Context Protocol amigable con IA y con prioridad en la seguridad para TestLink 1.9.20. Expone herramientas normalizadas de descubrimiento y análisis, paginación por cursor acotada, salida estructurada y escrituras con vista previa antes de aplicar a través de stdio.

Este repositorio es una implementación limpia basada en la interfaz XML-RPC pública de TestLink y en el SDK público de MCP. No depende de ningún paquete privado de TestLink ni de un árbol de código fuente privado.

Características

• Se inicia sin credenciales para que los clientes MCP puedan descubrir todas las herramientas, recursos e indicaciones.

• Modo de demostración determinista explícito para evaluación e incorporación.

• structuredContent, outputSchema, anotaciones de herramientas, paginación por cursor y códigos de error estables.

• Solo metadatos de adjuntos; el contenido de los adjuntos y las cargas útiles base64 se eliminan.

• Escrituras deshabilitadas por defecto. No existe herramienta de eliminación.

• Cada aplicación requiere confirm: true, una vista previa no caducada de 10 minutos y una instantánea del servidor sin cambios.

• Las llamadas con efectos secundarios nunca se reintentan automáticamente; los intentos de aplicación se registran en un registro de operaciones redactado.

• Una protección en tiempo de ejecución bloquea versiones de Node impares no compatibles o al final de su vida útil y niveles de parches de seguridad por debajo del mínimo declarado.

Related MCP server: TestRail MCP Server

Requisitos

• Node.js ^22.23.2 || ^24.18.1 || ^26.5.1

• TestLink 1.9.20 con su API XML-RPC habilitada

La base de desarrollo y contenedor es Node 24.19.0 LTS. CI también ejecuta Node 22.23.2 y 26.7.0.

Inicio rápido

nvm use
npm ci
npm run build
TESTLINK_DEMO_MODE=true node dist/cli.js

Invocación futura de npm tras la publicación:

npx -y testlink-mcp@1.0.0

Configuración del cliente MCP:

{
  "mcpServers": {
    "testlink": {
      "command": "npx",
      "args": ["-y", "testlink-mcp@1.0.0"],
      "env": {
        "TESTLINK_URL": "https://testlink.example.com/testlink",
        "TESTLINK_DEV_KEY": "your-testlink-dev-key"
      }
    }
  }
}

No pongas credenciales reales en archivos rastreados. Copia .env.example a un .env ignorado, o inyecta variables de entorno desde tu cliente MCP o gestor de secretos.

Herramientas

Todas las herramientas devuelven:

{
  "ok": true,
  "data": {},
  "meta": {
    "source": "testlink",
    "requestId": "..."
  }
}

Los fallos usan ok: false con { code, message, retryable, details? }. Los consumidores deben ramificarse según error.code, no según el texto del mensaje.

Flujo de trabajo de escritura segura

1. Busca un caso existente y recupera su versión actual.

2. Valida el caso de prueba deseado.

3. Llama a la herramienta de vista previa correspondiente.

4. Muestra proposedChanges al usuario y obtén confirmación explícita.

5. Llama a apply con el ID de vista previa y confirm: true en un plazo de 10 minutos.

6. Si apply devuelve CONFLICT o PREVIEW_EXPIRED, crea y revisa una nueva vista previa.

Activa las escrituras solo en el proceso del servidor que deba realizarlas:

TESTLINK_WRITE_ENABLED=true npx -y testlink-mcp@1.0.0

La ruta predeterminada del registro es ~/.local/state/testlink-mcp/operations.jsonl. Sobrescríbela con TESTLINK_LEDGER_PATH. El registro contiene hashes y resultados redactados, no claves de desarrollador.

Configuración

El modo demo es explícito y prevalece sobre la configuración remota:

TESTLINK_DEMO_MODE=true TESTLINK_WRITE_ENABLED=true node dist/cli.js

Desarrollo

npm ci
npm run check
npm test
npm run eval
npm run build
npm audit --omit=dev --audit-level=high
npm pack --dry-run

La evaluación offline de selección de herramientas comprueba que las intenciones comunes de usuario seleccionen de manera diferenciada las herramientas de búsqueda, validación, vista previa y aplicación. Es determinista y no envía datos a un modelo externo.

Docker

La imagen se ejecuta como un usuario no root y usa Node 24.19.0. Crea la imagen sin publicar:

docker buildx build --platform linux/amd64,linux/arm64 --tag testlink-mcp:local --output type=oci,dest=testlink-mcp.oci.tar .

Nombre futuro de la imagen tras aprobación y publicación: ghcr.io/easonlin/testlink-mcp:1.0.0.

Política de publicación

La versión 1.0.0 está lista para su lanzamiento, pero la publicación sigue siendo una acción explícita. El flujo de trabajo de publicación protegido requiere una etiqueta de versión firmada, vuelve a ejecutar todas las compuertas de pruebas/evaluación/auditoría/SBOM/paquete, publica npm con procedencia, publica una imagen GHCR multiarquitectura con SBOM y procedencia, crea un GitHub Release y, finalmente, publica la entrada validada del Registro MCP.

Un flujo de trabajo protegido separado de prueba de humo en vivo verifica el paquete instalado contra una instancia real de TestLink 1.9.20 mediante llamadas de solo lectura. Su URL y clave de desarrollador deben almacenarse como secretos de entorno y nunca se escriben en los registros.

El manifiesto del paquete y server.json comparten el nombre MCP io.github.easonlin/testlink-mcp. La validación del Registro se puede ejecutar sin publicar:

mcp-publisher validate server.json

Referencias públicas

• Código fuente y rama de publicación de TestLink 1.9.20

• Model Context Protocol TypeScript SDK

• Comandos oficiales de publicación del Registro MCP

Licencia

MIT