Currents

Servidor MCP de Currents

Dale a tus agentes de codificación con IA visibilidad completa sobre los resultados de tus pruebas de CI. El servidor MCP de Currents conecta herramientas como Cursor y Claude directamente con tu panel de Currents, para que los agentes puedan diagnosticar pruebas flaky, identificar fallos y actuar sobre datos de ejecución reales, sin salir de tu editor.

• Consulta ejecuciones, archivos de especificación y resultados de pruebas individuales desde CI
• Superficie de tendencias de errores y métricas de rendimiento en todo tu conjunto de pruebas
• Gestiona reglas de cuarentena, webhooks y configuraciones de proyecto de forma programática
• Permite que los agentes corrijan lo que está roto usando resultados de pruebas reales, no suposiciones

Herramientas

Herramienta	Descripción
currents-list-actions	Lista todas las acciones de un proyecto con filtrado opcional.
currents-create-action	Crea una nueva acción para un proyecto.
currents-get-action	Obtiene una sola acción por ID.
currents-update-action	Actualiza una acción existente.
currents-delete-action	Elimina (archiva) una acción.
currents-enable-action	Habilita una acción deshabilitada.
currents-disable-action	Deshabilita una acción activa.
currents-list-affected-tests	Lista pruebas afectadas por acciones (cuarentena, omisión, etiqueta) para un proyecto dentro de un rango de fechas.
currents-get-affected-test-executions	Clave en una prueba: lista las ejecuciones de una prueba a las que se aplicó una acción, dentro de un rango de fechas, con la ejecución, la rama y el commit de cada una.
currents-get-action-executions	Clave en una acción: lista las ejecuciones de prueba a las que se aplicó una regla, en todas las pruebas que tocó, dentro de un rango de fechas.
currents-get-projects	Recupera los proyectos disponibles en la plataforma Currents.
currents-get-project	Obtiene un solo proyecto por ID.
currents-get-project-insights	Obtiene métricas agregadas de ejecuciones y pruebas para un proyecto dentro de un rango de fechas.
currents-list-pull-requests	Lista tarjetas de solicitudes de extracción para un proyecto (ejecuciones agrupadas por meta.pr.id).
currents-list-project-terms	Lista términos de proyecto paginados por cursor para un tipo (etiqueta, rama, nombre de autor, etc.).
currents-create-jira-issue	Crea un problema de Jira desde una prueba de ejecución usando la integración de Jira de la organización.
currents-link-jira-issue	Vincula un problema de Jira existente a una prueba de ejecución usando la integración de Jira de la organización.
currents-list-jira-projects	Lista los proyectos de Jira disponibles para la integración de la organización.
currents-list-jira-issue-types	Lista los tipos de problemas y campos personalizados de Jira para un proyecto de Jira.
currents-get-runs	Recupera una lista de ejecuciones para un proyecto específico con filtrado opcional.
currents-get-run-details	Recupera los detalles de una ejecución de prueba específica.
currents-find-run	Encuentra una ejecución por parámetros de consulta.
currents-cancel-run	Cancela una ejecución en curso.
currents-reset-run	Restablece archivos de especificación fallidos en una ejecución para permitir su re-ejecución.
currents-delete-run	Elimina una ejecución y todos los datos asociados.
currents-cancel-run-github-ci	Cancela una ejecución por ID de ejecución de flujo de trabajo de GitHub Actions y número de intento.
currents-get-spec-instance	Recupera datos de depuración de una ejecución específica de un archivo de especificación de prueba por instanceId.
currents-get-spec-files-performance	Recupera métricas de rendimiento de archivos de especificación para un proyecto específico dentro de un rango de fechas.
currents-get-tests-performance	Recupera métricas de prueba agregadas para un proyecto específico dentro de un rango de fechas.
currents-get-tests-signatures	Genera una firma de prueba única basada en el proyecto, la ruta del archivo de especificación y el título de la prueba.
currents-get-test-results	Recupera los resultados históricos de ejecución de pruebas para una firma de prueba específica.
currents-get-context	Úsalo para corregir pruebas que fallaron en CI: devuelve los errores, pasos y archivos de las pruebas fallidas de una ejecución, un archivo de especificaciones (instancia) o una prueba — el mismo contenido que Fix en el panel de Currents.
currents-get-errors-explorer	Obtén métricas de errores agregadas para un proyecto dentro de un rango de fechas.
currents-get-test-evidence	Recopila artefactos de evidencia (capturas de pantalla, videos, trazas, adjuntos) producidos por pruebas en una ejecución de CI, con URLs de descarga firmadas agrupadas por prueba.
currents-create-evidence-links	Crea un enlace compartible a la evidencia del intento de una prueba, servido desde su traza de Playwright, y las URLs hacia él: un resumen en markdown de lo que hizo el intento y lo que falló, una tira de imágenes, una grabación de pantalla animada, instantáneas del DOM, solicitudes de red y adjuntos.
currents-create-session	Registra una sesión de navegador que condujiste como una ejecución de Currents, para que su evidencia pueda leerse y compartirse como la de una ejecución de CI.
currents-list-webhooks	Lista todos los webhooks de un proyecto.
currents-create-share-link	Crea un enlace público a los resultados de pruebas que cualquiera puede abrir sin iniciar sesión, hasta que expire. El propósito "fix" es el contexto de fallo, para un agente que corregirá las pruebas — el mismo contenido que currents-get-context, con pruebas flaky incluidas y marcadas como flaky. El propósito "report" lista cada prueba con sus intentos y archivos, para una persona.
currents-create-webhook	Crea un nuevo webhook para un proyecto.
currents-get-webhook	Obtén un único webhook por ID.
currents-update-webhook	Actualiza un webhook existente.
currents-delete-webhook	Elimina un webhook.

Habilidades

Habilidades de agente que enseñan a los agentes de IA flujos de trabajo de Currents en varios pasos.

Habilidad	Descripción
browser-evidence	Experimental.
collect-evidence	Demuestra que el trabajo que implementaste realmente funciona, o haz una demo, a partir de pruebas que se ejecutaron en CI mediante Currents — un enlace de seguimiento cuyo resumen, tira de imágenes y capturas de accesibilidad se leen dentro de un comentario, además de capturas de pantalla, archivos adjuntos y videos.
fix-failing-tests	Corrige pruebas que fallaron en CI, usando los resultados que Currents registró — errores, pasos, seguimientos, capturas de pantalla y salida de consola.

El servidor publica cada habilidad como un recurso MCP, por lo que un agente conectado puede listarlas y leerlas sin una copia local:

skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md

Los agentes que cargan habilidades solo desde el disco aún necesitan una copia — coloca el directorio de habilidades en la ubicación de habilidades del agente (por ejemplo, .claude/skills/ para Claude Code).

Configuración

Clave de API

Obtén una clave de API de Currents siguiendo las instrucciones aquí.

Uso con Cursor

1. Ve a Configuración de Cursor > MCP > Habilitar
2. Agrega lo siguiente a tu mcp.json.

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Ejecuta este comando para agregar Currents MCP a Claude Code

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

Agrega lo siguiente para habilitar Currents MCP en Claude Desktop (edita el archivo claude_desktop_config.json):

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Endpoint MCP remoto (alojado)

Además del transporte local stdio anterior, el mismo servidor puede ejecutarse como un endpoint HTTP Streamable alojado (por ejemplo, https://mcp.currents.dev/mcp) para usarse con conectores remotos como las aplicaciones web/móviles de Claude.

El servidor alojado no realiza autenticación propia. Cada solicitud debe llevar tu clave de API de Currents como un token Bearer, que se pasa a la API de Currents:

Authorization: Bearer <your-currents-api-key>

Ejemplo de configuración de cliente (conector remoto):

{
  "mcpServers": {
    "currents": {
      "url": "https://mcp.currents.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Ejecutar el servidor HTTP tú mismo:

# from the mcp-server package
npm run build && PORT=3000 npm run start:http
# or via Docker (serves /mcp, exposes the configured PORT)
docker build -t currents-mcp . && docker run -p 3000:3000 currents-mcp

El servidor Node habla HTTP simple; TLS y el dominio público terminan en el proxy inverso / balanceador de carga frente al contenedor. Se proporciona un endpoint GET /healthz para verificaciones de disponibilidad.

⚠️ Aviso

Al conectar herramientas de IA (por ejemplo, mediante MCP) a Currents, les estás otorgando acceso a tu clave de API, resultados de pruebas y metadatos de CI. Es tu responsabilidad evaluar cualquier agente o servicio de IA que uses, y asegurarte de que manejen tus datos de forma segura.

Referencias

• Currents
• Documentación de Currents
• Guía de contribución
• Publicación y lanzamiento
• Licencia