Currents

Currents MCP Server

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

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

Инструменты

Tool	Description
currents-list-actions	Список всех действий для проекта с возможностью фильтрации.
currents-create-action	Создание нового действия для проекта.
currents-get-action	Получение одного действия по идентификатору.
currents-update-action	Обновление существующего действия.
currents-delete-action	Удаление (архивирование) действия.
currents-enable-action	Включение отключенного действия.
currents-disable-action	Отключение активного действия.
currents-list-affected-tests	Список тестов, затронутых действиями (карантин, пропуск, тег) для проекта в пределах диапазона дат.
currents-get-affected-test-executions	Привязано к тесту: перечисляет выполнения одного теста, к которым было применено действие, в пределах диапазона дат, с указанием запуска, ветки и коммита для каждого.
currents-get-action-executions	Привязано к действию: перечисляет выполнения тестов, к которым было применено одно правило, по всем затронутым тестам, в пределах диапазона дат.
currents-get-projects	Получение проектов, доступных в платформе Currents.
currents-get-project	Получение одного проекта по идентификатору.
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	Отмена запуска по идентификатору рабочего процесса 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	Используется для исправления тестов, упавших в CI: возвращает ошибки, шаги и файлы упавших тестов запуска, файла спецификации (экземпляра) или одного теста — то же содержимое, что и Fix в панели управления Currents.
currents-get-errors-explorer	Получает агрегированные метрики ошибок для проекта в пределах диапазона дат.
currents-get-test-evidence	Собирает артефакты доказательств (скриншоты, видео, трассировки, вложения), созданные тестами в CI-запуске, с подписанными URL для скачивания, сгруппированными по каждому тесту.
currents-create-evidence-links	Создает публичную ссылку на доказательства попытки теста, обслуживаемую из его трассировки Playwright, и URL на нее: markdown-сводку того, что сделала попытка и что не удалось, раскадровку, анимированную видеозапись экрана, снимки DOM, сетевые запросы и вложения.
currents-create-session	Записывает сеанс браузера, которым вы управляли, как запуск Currents, чтобы его доказательства можно было читать и делиться ими, как доказательствами CI-запуска.
currents-list-webhooks	Перечисляет все вебхуки для проекта.
currents-create-share-link	Создает публичную ссылку на результаты тестов, которую любой может открыть без входа в систему, до истечения срока действия. Назначение "fix" — это контекст сбоя для агента, который будет исправлять тесты — то же содержимое, что и currents-get-context, с включенными и помеченными как флаки флaky-тестами. Назначение "report" перечисляет каждый тест с его попытками и файлами, для человека.
currents-create-webhook	Создает новый вебхук для проекта.
currents-get-webhook	Получает один вебхук по ID.
currents-update-webhook	Обновляет существующий вебхук.
currents-delete-webhook	Удаляет вебхук.

Навыки

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

Навык	Описание
browser-evidence	Экспериментальный.
collect-evidence	Покажите, что реализованная вами работа действительно работает, или продемонстрируйте её, используя тесты, запущенные в CI через Currents — ссылка на трассировку, чей дайджест, раскадровка и снимки доступности читаются внутри комментария, плюс скриншоты, вложения и видео.
fix-failing-tests	Исправьте тесты, которые упали в CI, используя результаты, записанные Currents — ошибки, шаги, трассировки, скриншоты и вывод консоли.

Сервер публикует каждый навык как ресурс 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
• Руководство по внесению вклада
• Релизы и публикация
• Лицензия