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 a tu panel de Currents, para que los agentes puedan diagnosticar pruebas inestables, identificar fallos y actuar sobre datos de ejecución reales, sin salir de tu editor.

• Consulta ejecuciones, archivos spec y resultados de pruebas individuales desde CI
• Muestra tendencias de errores y métricas de rendimiento en todo tu conjunto de pruebas
• Gestiona reglas de cuarentena, webhooks y ajustes de proyecto mediante programación
• Permite que los agentes arreglen 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 única 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 las pruebas afectadas por acciones (cuarentena, omitir, etiqueta) de un proyecto dentro de un rango de fechas.
currents-get-affected-test-executions	Obtiene los detalles de ejecución de una prueba afectada específica (por firma) dentro de un rango de fechas.
currents-get-affected-executions	Lista las ejecuciones de pruebas donde se aplicó una acción/regla específica, dentro de un rango de fechas.
currents-get-projects	Recupera los proyectos disponibles en la plataforma Currents.
currents-get-project	Obtiene un único proyecto por ID.
currents-get-project-insights	Obtiene métricas agregadas de ejecuciones y pruebas de un proyecto dentro de un rango de fechas.
currents-list-pull-requests	Lista las tarjetas de pull-request de un proyecto (ejecuciones agrupadas por meta.pr.id).
currents-list-project-terms	Lista términos de proyecto paginados por cursor para un tipo (tag, branch, authorName, etc.).
currents-create-jira-issue	Crea un issue de Jira a partir de una prueba de ejecución usando la integración de Jira de la organización.
currents-link-jira-issue	Vincula un issue 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 issue de Jira y los campos personalizados de un proyecto de Jira.
currents-get-runs	Recupera una lista de ejecuciones de 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 los archivos spec fallidos de 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 workflow 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 spec de prueba por instanceId.
currents-get-spec-files-performance	Recupera métricas de rendimiento de archivos spec para un proyecto específico dentro de un rango de fechas.
currents-get-tests-performance	Recupera métricas de pruebas 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 spec y el título de la prueba.
currents-get-test-results	Recupera resultados históricos de ejecución de pruebas para una firma de prueba específica.
currents-get-context	Obtiene el contexto de fallo de pruebas para depuración con IA a nivel de ejecución, instancia o prueba.
currents-get-errors-explorer	Obtiene 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 las pruebas en una ejecución de CI, con URLs de descarga firmadas agrupadas por prueba.
currents-list-webhooks	Lista todos los webhooks de un proyecto.
currents-create-webhook	Crea un nuevo webhook para un proyecto.
currents-get-webhook	Obtiene 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 de varios pasos.

Habilidad	Descripción
collect-evidence	Demuestra que el trabajo implementado funciona, o haz una demo, usando artefactos de pruebas de CI: capturas de pantalla antes/después, adjuntos de texto, videos, trazas.

El servidor publica cada habilidad como un recurso MCP, de modo 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 (p. ej., .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. Añade 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 añadir Currents MCP a Claude Code

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

Añade 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 (p. ej., 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 token Bearer, que se transmite 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"
      }
    }
  }
}

Ejecutando 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 plano; TLS y el dominio público terminan en el proxy inverso / balanceador de carga frente al contenedor. Se proporciona un endpoint GET /healthz para comprobaciones de disponibilidad.

⚠️ Aviso

Al conectar herramientas de IA (p. ej., 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