Currents

Currents MCP Server

Предоставьте вашим AI-кодинг-агентам полную видимость результатов CI-тестов. Currents MCP Server подключает такие инструменты, как Cursor и Claude, напрямую к вашему дашборду Currents, чтобы агенты могли диагностировать флаки-тесты, выявлять сбои и работать с реальными данными выполнения — не покидая редактор.

• Запрашивайте прогоны, файлы спецификаций и отдельные результаты тестов из CI
• Отслеживайте тренды ошибок и метрики производительности по всему набору тестов
• Управляйте правилами карантина, вебхуками и настройками проектов программно
• Позвольте агентам исправлять то, что сломано, используя реальные выходные данные тестов, а не догадки

Инструменты

Инструмент	Описание
currents-list-actions	Список всех действий для проекта с необязательной фильтрацией.
currents-create-action	Создание нового действия для проекта.
currents-get-action	Получение одного действия по ID.
currents-update-action	Обновление существующего действия.
currents-delete-action	Удаление (архивирование) действия.
currents-enable-action	Включение отключенного действия.
currents-disable-action	Отключение активного действия.
currents-list-affected-tests	Список тестов, затронутых действиями (карантин, пропуск, тег), для проекта в пределах диапазона дат.
currents-get-affected-test-executions	Получение деталей выполнения для конкретного затронутого теста (по сигнатуре) в пределах диапазона дат.
currents-get-affected-executions	Список выполнений тестов, где было применено конкретное действие/правило, в пределах диапазона дат.
currents-get-projects	Получение проектов, доступных на платформе Currents.
currents-get-project	Получение одного проекта по ID.
currents-get-project-insights	Получение агрегированных метрик прогонов и тестов для проекта в пределах диапазона дат.
currents-list-pull-requests	Список карточек pull-request для проекта (прогоны, сгруппированные по meta.pr.id).
currents-list-project-terms	Список терминов проекта с курсорной пагинацией для одного типа (tag, branch, authorName и т.д.).
currents-create-jira-issue	Создание задачи Jira из теста прогона с использованием интеграции Jira организации.
currents-link-jira-issue	Привязка существующей задачи Jira к тесту прогона с использованием интеграции Jira организации.
currents-list-jira-projects	Список проектов Jira, доступных для интеграции организации.
currents-list-jira-issue-types	Список типов задач и пользовательских полей Jira для проекта Jira.
currents-get-runs	Получение списка прогонов для конкретного проекта с необязательной фильтрацией.
currents-get-run-details	Получение деталей конкретного тестового прогона.
currents-find-run	Поиск прогона по параметрам запроса.
currents-cancel-run	Отмена выполняющегося прогона.
currents-reset-run	Сброс неудачных файлов спецификаций в прогоне для повторного выполнения.
currents-delete-run	Удаление прогона и всех связанных данных.
currents-cancel-run-github-ci	Отмена прогона по ID рабочего процесса GitHub Actions и номеру попытки.
currents-get-spec-instance	Получение данных отладки из конкретного выполнения файла спецификации теста по instanceId.
currents-get-spec-files-performance	Получение метрик производительности файлов спецификаций для конкретного проекта в пределах диапазона дат.
currents-get-tests-performance	Получение агрегированных метрик тестов для конкретного проекта в пределах диапазона дат.
currents-get-tests-signatures	Генерация уникальной сигнатуры теста на основе проекта, пути к файлу спецификации и заголовка теста.
currents-get-test-results	Получение исторических результатов выполнения тестов для конкретной сигнатуры теста.
currents-get-context	Получение контекста сбоя теста для AI-отладки на уровне прогона, экземпляра или теста.
currents-get-errors-explorer	Получение агрегированных метрик ошибок для проекта в пределах диапазона дат.
currents-get-test-evidence	Сбор артефактов доказательств (скриншоты, видео, трассировки, вложения), созданных тестами в CI-прогоне, с подписанными URL для загрузки, сгруппированными по тестам.
currents-list-webhooks	Список всех вебхуков для проекта.
currents-create-webhook	Создание нового вебхука для проекта.
currents-get-webhook	Получение одного вебхука по ID.
currents-update-webhook	Обновление существующего вебхука.
currents-delete-webhook	Удаление вебхука.

Навыки

Навыки агента, которые обучают AI-агентов многошаговым рабочим процессам Currents.

Навык	Описание
collect-evidence	Покажите, что реализованная работа работает, или продемонстрируйте её, используя артефакты CI-тестов — скриншоты до/после, текстовые вложения, видео, трассировки.

Сервер публикует каждый навык как ресурс MCP, поэтому подключенный агент может перечислять и читать их без локальной копии:

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

Агентам, которые загружают навыки только с диска, всё ещё нужна копия — поместите каталог навыков в расположение навыков агента (например, .claude/skills/ для Claude Code).

Настройка

API-ключ

Получите API-ключ Currents, следуя инструкциям здесь.

Использование с Cursor

1. Перейдите в Cursor Settings > MCP > Enable
2. Добавьте следующее в ваш mcp.json.

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

Claude

Выполните эту команду, чтобы добавить Currents MCP в Claude Code

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

Добавьте следующее, чтобы включить Currents MCP на Claude Desktop (отредактируйте файл claude_desktop_config.json):

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

Удалённая (хостинговая) MCP-конечная точка

В дополнение к локальному транспорту stdio выше, тот же сервер может работать как хостинговая конечная точка Streamable HTTP (например, https://mcp.currents.dev/mcp) для использования с удалёнными коннекторами, такими как веб/мобильные приложения Claude.

Хостинговый сервер не выполняет собственную аутентификацию. Каждый запрос должен содержать ваш API-ключ Currents как Bearer-токен, который передаётся в API Currents:

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

Пример конфигурации клиента (удалённый коннектор):

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

Запуск HTTP-сервера самостоятельно:

# 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

Node-сервер говорит по обычному HTTP; TLS и публичный домен завершаются на обратном прокси / балансировщике нагрузки перед контейнером. Конечная точка GET /healthz предоставляется для проверок живости.

⚠️ Уведомление

Подключая AI-инструменты (например, через MCP) к Currents, вы предоставляете им доступ к вашему API-ключу, результатам тестов и метаданным CI. Вы несёте ответственность за проверку любых AI-агентов или сервисов, которые вы используете, и за обеспечение безопасной обработки ваших данных.

Ссылки

• Currents
• Документация Currents
• Руководство по внесению вклада
• Релизы и публикация
• Лицензия