Currents MCP Server

Currents MCP Server

Dê aos seus agentes de codificação com IA visibilidade total sobre os resultados dos testes de CI. O Currents MCP Server conecta ferramentas como Cursor e Claude diretamente ao seu painel do Currents, para que os agentes possam diagnosticar testes instáveis, identificar falhas e agir com base em dados reais de execução — sem sair do seu editor.

• Consulte execuções, arquivos de especificação e resultados de testes individuais do CI
• Exponha tendências de erro e métricas de desempenho em toda a sua suíte de testes
• Gerencie regras de quarentena, webhooks e configurações do projeto de forma programática
• Permita que os agentes corrijam o que está quebrado usando a saída real dos testes, não suposições

Ferramentas

Ferramenta	Descrição
currents-list-actions	Lista todas as ações de um projeto com filtragem opcional.
currents-create-action	Cria uma nova ação para um projeto.
currents-get-action	Obtém uma única ação pelo ID.
currents-update-action	Atualiza uma ação existente.
currents-delete-action	Exclui (arquiva) uma ação.
currents-enable-action	Habilita uma ação desabilitada.
currents-disable-action	Desabilita uma ação ativa.
currents-list-affected-tests	Lista os testes afetados por ações (quarentena, pular, tag) para um projeto dentro de um intervalo de datas.
currents-get-affected-test-executions	Obtém detalhes de execução para um teste afetado específico (por assinatura) dentro de um intervalo de datas.
currents-get-affected-executions	Lista as execuções de teste onde uma ação/regra específica foi aplicada, dentro de um intervalo de datas.
currents-get-projects	Recupera os projetos disponíveis na plataforma Currents.
currents-get-project	Obtém um único projeto pelo ID.
currents-get-project-insights	Obtém métricas agregadas de execuções e testes para um projeto dentro de um intervalo de datas.
currents-list-pull-requests	Lista cartões de pull request para um projeto (execuções agrupadas por meta.pr.id).
currents-list-project-terms	Lista termos do projeto paginados por cursor para um tipo (tag, branch, authorName, etc.).
currents-create-jira-issue	Cria uma issue do Jira a partir de um teste de execução usando a integração Jira da organização.
currents-link-jira-issue	Vincula uma issue existente do Jira a um teste de execução usando a integração Jira da organização.
currents-list-jira-projects	Lista os projetos Jira disponíveis para a integração da organização.
currents-list-jira-issue-types	Lista os tipos de issue e campos personalizados do Jira para um projeto Jira.
currents-get-runs	Recupera uma lista de execuções para um projeto específico com filtragem opcional.
currents-get-run-details	Recupera detalhes de uma execução de teste específica.
currents-find-run	Encontra uma execução por parâmetros de consulta.
currents-cancel-run	Cancela uma execução em andamento.
currents-reset-run	Redefine arquivos de especificação com falha em uma execução para permitir a re-execução.
currents-delete-run	Exclui uma execução e todos os dados associados.
currents-cancel-run-github-ci	Cancela uma execução pelo ID da execução do workflow do GitHub Actions e número da tentativa.
currents-get-spec-instance	Recupera dados de depuração de uma execução específica de um arquivo de especificação de teste por instanceId.
currents-get-spec-files-performance	Recupera métricas de desempenho de arquivos de especificação para um projeto específico dentro de um intervalo de datas.
currents-get-tests-performance	Recupera métricas agregadas de teste para um projeto específico dentro de um intervalo de datas.
currents-get-tests-signatures	Gera uma assinatura de teste única com base no projeto, caminho do arquivo de especificação e título do teste.
currents-get-test-results	Recupera resultados históricos de execução de teste para uma assinatura de teste específica.
currents-get-context	Obtém contexto de falha de teste para depuração por IA no nível de execução, instância ou teste.
currents-get-errors-explorer	Obtém métricas de erro agregadas para um projeto dentro de um intervalo de datas.
currents-list-webhooks	Lista todos os webhooks de um projeto.
currents-create-webhook	Cria um novo webhook para um projeto.
currents-get-webhook	Obtém um único webhook pelo ID.
currents-update-webhook	Atualiza um webhook existente.
currents-delete-webhook	Exclui um webhook.

Configuração

Chave de API

Obtenha uma chave de API do Currents seguindo as instruções aqui.

Uso com o Cursor

1. Vá para Configurações do Cursor > MCP > Habilitar
2. Adicione o seguinte ao seu mcp.json.

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

Claude

Execute este comando para adicionar o Currents MCP ao Claude Code

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

Adicione o seguinte para habilitar o Currents MCP no Claude Desktop (edite o arquivo claude_desktop_config.json):

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

⚠️ Aviso

Ao conectar ferramentas de IA (por exemplo, via MCP) ao Currents, você está concedendo a elas acesso à sua chave de API, resultados de testes e metadados de CI. É sua responsabilidade avaliar quaisquer agentes ou serviços de IA que você utiliza e garantir que eles manipulem seus dados com segurança.

Referências

• Currents
• Documentação do Currents
• Guia de Contribuição
• Lançamento e Publicação
• Licença