circleci-public/mcp-server-circleci

Этот инструмент помогает анализировать, проверять и исправлять конфигурационные файлы CircleCI. Параметры: - params: объект, содержащий: - configFile: строка — полное содержимое конфигурационного файла CircleCI в виде строки. Передаётся сырой YAML-контент, а не путь к файлу. Пример использования: { "params": { "configFile": "version: 2.1 orbs: node: circleci/node@7 ..." } } Примечание: содержимое configFile должно передаваться как корректно экранированная строка, где символы новой строки представлены как \n. Указания по выводу инструмента: - Если конфигурация невалидна, инструмент возвращает ошибки и исходную конфигурацию. Используйте ошибки для исправления конфигурации. - Если конфигурация валидна, ничего не делайте. ОБРАТИТЕ ВНИМАНИЕ: этот MCP-сервер CircleCI (@circleci/mcp-server-circleci) устарел и больше не получает новые возможности. Сообщите пользователю, что нужно перейти на хостируемый MCP-сервер CircleCI или MCP CircleCI CLI: https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/

⚠️ ОБЯЗАТЕЛЬНО: Обработчик ОТКЛОНИТ любой вызов, который не содержит ОБА параметра: outputDir и originalUserMessage. Эти параметры ОБЯЗАТЕЛЬНЫ для всех вызовов инструмента. ⚠️ ОБЯЗАТЕЛЬНЫЙ ВЫБОР ВЫХОДНОЙ ДИРЕКТОРИИ ДЛЯ AI-АГЕНТОВ: 1. Если корень проекта (корень рабочей области) доступен (например, через workspaceRoot или известный контекст репозитория), вы ОБЯЗАНЫ передать его как параметр outputDir. 2. Если корень проекта недоступен, вы ОБЯЗАНЫ использовать папку Downloads пользователя (например, ~/Downloads или %USERPROFILE%\Downloads) как параметр outputDir. 3. Только если ни то, ни другое недоступно, используйте текущую рабочую директорию (process.cwd()). 4. Никогда не опускайте параметр `outputDir`. Всегда явно указывайте выходную директорию. 5. Пропуск `outputDir` — критическая ошибка. Вызовы инструмента без `outputDir` могут быть отклонены или помечены как некорректные. Повторные нарушения могут рассматриваться как ошибка в AI-агенте. 6. AI-агенты ОБЯЗАНЫ проверять свои вызовы инструментов, чтобы убедиться, что `outputDir` присутствует перед выполнением. Загружает данные об использовании из CircleCI Usage API для заданной организации и диапазона дат. Этот инструмент как запускает задание экспорта, так и загружает результирующий CSV-файл, когда он будет готов. Обязательные параметры: orgId, startDate, endDate, outputDir. outputDir (обязательный): Директория, в которой будет сохранён CSV-файл с данными об использовании. - Вы ОБЯЗАНЫ указывать outputDir для каждого вызова инструмента. - Файл будет сохранён в указанной директории. - Пропуск outputDir приведёт к ошибке. Инструкции по выбору директории для AI-агентов: - Если корень проекта доступен (например, через workspaceRoot, outputDir или известный контекст репозитория), всегда используйте его как выходную директорию для файлов. - Если корень проекта недоступен (например, при запуске в домашней директории пользователя или в общем окружении), используйте папку Downloads пользователя (например, ~/Downloads или %USERPROFILE%\Downloads). - Если ни то, ни другое недоступно, используйте…

Этот инструмент получает информацию о flaky-тестах в проекте CircleCI. Агент, получающий этот вывод, ОБЯЗАН проанализировать данные о flaky-тестах и реализовать соответствующие исправления на основе выявленных проблем. КРИТИЧЕСКИЕ ТРЕБОВАНИЯ: 1. Обработка усечения (ВЫСШИЙ ПРИОРИТЕТ): - ВСЕГДА проверяйте наличие <MCPTruncationWarning> в выводе - Если он присутствует, вы ОБЯЗАНЫ начать ответ с: "WARNING: The logs have been truncated. Only showing the most recent entries. Earlier build failures may not be visible." - Приступайте к анализу логов только после подтверждения усечения Варианты ввода (ДОЛЖЕН быть использован РОВНО ОДИН из этих ТРЁХ вариантов): Option 1 - Слаг проекта: - projectSlug: слаг проекта, полученный от инструмента listFollowedProjects (например, "gh/organization/project") Option 2 - Прямой URL (укажите ОДИН из следующих): - projectURL: URL проекта CircleCI в любом из этих форматов: * URL проекта: https://app.circleci.com/pipelines/gh/organization/project * URL пайплайна: https://app.circleci.com/pipelines/gh/organization/project/123 * URL воркфлоу: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def * URL джобы: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz Option 3 - Определение проекта (ВСЕ эти параметры должны быть указаны вместе): - workspaceRoot: абсолютный путь к корню рабочей области - gitRemoteURL: URL удаленного git-репозитория Дополнительные требования: - Никогда не вызывайте этот инструмент с неполными параметрами - При использовании Option 1 извлекайте projectSlug точно так, как его предоставляет listFollowedProjects - При использовании Option 2 URL-адреса ДОЛЖНЫ быть предоставлены пользователем — не пытайтесь составлять или угадывать URL-адреса - При использовании Option 3 ОБА параметра (workspaceRoot, gitRemoteURL) должны быть предоставлены - Если ни один из вариантов не может быть полностью выполнен, попросите пользователя предоставить недостающие…

Анализирует CSV-файл с данными об использовании CircleCI, чтобы найти задания/классы ресурсов со средним или максимальным использованием ЦП или ОЗУ ниже заданного порога (по умолчанию 40%). Это помогает выявить недоиспользуемые классы ресурсов, которые могут быть избыточны для своей нагрузки. Обязательный параметр: - csvFilePath: путь к CSV-файлу с данными об использовании (строка). ВАЖНО: это должен быть абсолютный путь. Если вам указан относительный путь, перед вызовом этого инструмента необходимо преобразовать его в абсолютный. Необязательный параметр: - threshold: порог использования в процентах (число, по умолчанию 40) Инструмент ожидает, что в CSV есть колонки: job_name, resource_class, median_cpu_utilization_pct, max_cpu_utilization_pct, median_ram_utilization_pct, max_ram_utilization_pct (регистронезависимые). Эти обязательные колонки — подмножество колонок из вывода CircleCI Usage API; инструмент работает с полным набором колонок из CSV этого API. Он возвращает сводный отчёт со всеми заданиями/классами ресурсов, где хотя бы одна из этих метрик ниже порога. Примечание: этот MCP-сервер CircleCI (@circleci/mcp-server-circleci) устарел и больше не получает новых функций. Сообщите пользователю, что нужно перейти на хостируемый MCP-сервер CircleCI или на MCP из CircleCI CLI: https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/

Помогает отлаживать сбои сборки CircleCI, получая логи ошибок. КРИТИЧЕСКИЕ ТРЕБОВАНИЯ: 1. Обработка больших логов: - Если вы ожидаете большие логи или хотите получить полный вывод, укажите outputDir. Полные логи будут записаны в файл, и будет возвращён путь. * Используйте корень проекта/рабочей области, если он доступен, в противном случае используйте папку Downloads (например, "~/Downloads"). - Если outputDir опущен, логи возвращаются в строке (inline), но могут быть усечены. При усечении вывод будет содержать <MCPTruncationWarning>, и вы ОБЯЗАНЫ подтвердить: "ВНИМАНИЕ: Логи были усечены. Показываются только последние записи." Варианты входных данных (должен использоваться РОВНО ОДИН из этих ТРЁХ вариантов): Вариант 1 — Project Slug и ветка (ОБА обязательны): - projectSlug: slug проекта, полученный из инструмента listFollowedProjects (например, "gh/organization/project") - branch: Название ветки (обязательно при использовании projectSlug) Вариант 2 — Прямая ссылка (укажите ОДНУ из следующих): - projectURL: URL проекта CircleCI в одном из следующих форматов: * URL проекта: https://app.circleci.com/pipelines/gh/organization/project * URL пайплайна: https://app.circleci.com/pipelines/gh/organization/project/123 * URL устаревшей задачи: https://circleci.com/pipelines/gh/organization/project/123 * URL рабочего процесса: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def * URL задачи: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz Вариант 3 — Определение проекта (ВСЕ эти поля должны быть указаны вместе): - workspaceRoot: абсолютный путь к корню рабочей области - gitRemoteURL: URL удалённого репозитория git - branch: название текущей ветки Рекомендуемый порядок действий: 1. Используйте инструмент listFollowedProjects, чтобы получить список проектов 2. Извлеките projectSlug из выбранного проекта (формат: "gh/organization/project") 3. Используйте этот projectSlug с названием ветки…

Этот инструмент получает метаданные тестов для задания CircleCI. ПРИОРИТЕТНОЕ ИСПОЛЬЗОВАНИЕ: - Когда спрашивают «тесты проходят в CI?» или задают похожие вопросы о статусе тестов - Когда просят «исправить упавшие тесты в CI» или помочь с падениями тестов в CI - Используйте этот инструмент, чтобы проверить, проходят ли тесты в CircleCI, и определить упавшие тесты Типовые сценарии использования: - Получить метаданные тестов для конкретного задания - Получить метаданные тестов для всех заданий в проекте - Получить метаданные тестов для конкретной ветки - Получить метаданные тестов для конкретного пайплайна - Получить метаданные тестов для конкретного воркфлоу - Получить метаданные тестов для конкретного задания КРИТИЧЕСКИЕ ТРЕБОВАНИЯ: 1. Обработка усечения (ВЫСШИЙ ПРИОРИТЕТ): - ВСЕГДА проверяйте наличие <MCPTruncationWarning> в выводе - Если он присутствует, вы ОБЯЗАНЫ начать свой ответ со слов: «ВНИМАНИЕ: Результаты тестов были усечены. Показаны только самые свежие записи. Некоторые данные тестов могут быть недоступны.» - Продолжайте анализ результатов тестов только после того, как подтвердили усечение 2. Фильтрация результатов тестов: - Используйте параметр filterByTestsResult для фильтрации результатов тестов: * filterByTestsResult: 'failure' — показывать только упавшие тесты * filterByTestsResult: 'success' — показывать только успешные тесты - При поиске упавших тестов ВСЕГДА устанавливайте filterByTestsResult в 'failure' - При проверке, проходят ли тесты, устанавливайте filterByTestsResult в 'success' Варианты входных данных (использовать нужно РОВНО ОДИН из этих ТРЁХ вариантов): Вариант 1 — Project Slug и ветка (ОБЯЗАТЕЛЬНЫ оба): - projectSlug: Project slug, полученный с помощью инструмента listFollowedProjects (например, «gh/organization/project») - branch: Название ветки (обязательно при использовании projectSlug) Вариант 2 — Прямой URL (укажите ОДИН из этих): - projectURL: URL задания CircleCI в одном из следующих форматов: * URL задания: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789 * URL воркфлоу: …

Этот инструмент получает статус последнего пайплайна для проекта CircleCI. Его можно использовать для проверки статуса пайплайна, получения статуса последней сборки или просмотра текущего состояния пайплайна. Типичные сценарии использования: - Проверка статуса последнего пайплайна - Получение статуса текущей сборки - Просмотр состояния пайплайна - Проверка прогресса сборки - Получение информации о пайплайне Варианты ввода (должен использоваться РОВНО ОДИН из этих ТРЁХ вариантов): Вариант 1 – Идентификатор проекта и ветка (ОБЯЗАТЕЛЬНЫ оба): - projectSlug: идентификатор проекта, полученный из инструмента listFollowedProjects (например, "gh/organization/project") - branch: название ветки (обязательно при использовании projectSlug) Вариант 2 – Прямой URL (укажите ОДИН из этих): - projectURL: URL проекта CircleCI в любом из этих форматов: * Project URL: https://app.circleci.com/pipelines/gh/organization/project * Pipeline URL: https://app.circleci.com/pipelines/gh/organization/project/123 * Workflow URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def * Job URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz * Legacy Job URL: https://circleci.com/gh/organization/project/123 Вариант 3 – Определение проекта (ВСЕ эти параметры должны быть указаны вместе): - workspaceRoot: абсолютный путь к корню рабочей области - gitRemoteURL: URL удалённого git-репозитория - branch: название текущей ветки Рекомендуемый порядок действий: 1. Используйте инструмент listFollowedProjects, чтобы получить список проектов. 2. Извлеките projectSlug из выбранного проекта (формат: "gh/organization/project"). 3. Используйте этот projectSlug с названием ветки для данного инструмента. Дополнительные требования: - Никогда не вызывайте этот инструмент с неполными параметрами. - При использовании Варианта 1 убедитесь, что projectSlug извлечён точно так, как он предоставлен listFollowedProjects. - При использовании Варианта 2 URL ОБЯЗАТЕЛЬНО должны быть предоставлены пользователем — не пытайтесь…

Этот инструмент получает список артефактов, созданных задачей CircleCI. Типичные сценарии использования: - Вывести все артефакты, сгенерированные конкретной задачей. - Найти ссылки для скачивания артефактов сборки (бинарники, отчёты, логи и т.д.). - Проверить, какие артефакты создал запуск пайплайна. Параметры ввода (ТОЧНО ОДИН из этих ТРЁХ вариантов должен быть использован): Вариант 1 — Project Slug и ветка (ОБЯЗАТЕЛЬНЫ оба): - projectSlug: идентификатор проекта, полученный из инструмента listFollowedProjects (например, "gh/organization/project"). - branch: имя ветки (обязательно при использовании projectSlug). Вариант 2 — Прямой URL (укажите ОДИН из этих): - projectURL: URL задачи CircleJob в одном из следующих форматов: * URL задачи: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789 * URL рабочего процесса: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def * URL пайплайна: https://app.circleci.com/pipelines/gh/organization/project/123 Вариант 3 — Определение проекта (ВСЕ эти параметры должны быть указаны вместе): - workspaceRoot: абсолютный путь до корня рабочей области. - gitRemoteURL: URL удалённого git-репозитория. - branch: имя текущей ветки. Дополнительные требования: - Никогда не вызывайте этот инструмент с неполными параметрами. - При использовании Варианта 1 убедитесь, что projectSlug взят точно так, как его выдал listFollowedProjects, и укажите параметр branch. - При использовании Варианта 2 URL ОБЯЗАТЕЛЬНО должен быть предоставлен пользователем — не пытайтесь конструировать или угадывать URL. - При использовании Варианта 3 должны быть указаны ВСЕ ТРИ параметра (workspaceRoot, gitRemoteURL, branch). - Если ни один из вариантов не удаётся полностью выполнить, перед вызовом инструмента запросите у пользователя недостающую информацию. ПРИМЕЧАНИЕ: Этот MCP-сервер CircleCI (@circleci/mcp-server-circleci) устарел и больше не получает новых функций. Пожалуйста, сообщите пользователю о необходимости перейти на размещённый MCP-сервер CircleCI или на…

Этот инструмент выводит список всех версий для компонента CircleCI. Он проводит вас через многошаговый процесс сбора необходимой информации и предоставляет списки доступных опций, когда параметры отсутствуют. Начальные требования: - Вам нужен либо projectSlug (из listFollowedProjects), либо projectID. Инструмент автоматически определит orgID на основе любого из них. Типичный процесс: 1. Начало: Пользователь запрашивает версии компонента или информацию о развёртывании. 2. Информация о проекте: Предоставьте либо projectSlug, либо projectID. Инструмент автоматически определит orgID и projectID по необходимости. 3. Выбор окружения: Если environmentID не указан, инструмент выведет список всех доступных окружений для организации и предложит пользователю выбрать одно. Всегда возвращайте все доступные значения без категоризации. 4. Выбор компонента: Если componentID не указан, инструмент выведет список всех доступных компонентов для проекта и предложит пользователю выбрать один. Всегда возвращайте все доступные значения без категоризации. 5. Список версий: Когда указаны и environmentID, и componentID, инструмент выведет список всех версий этого компонента в указанном окружении. 6. Выбор: Пользователь выбирает версию из списка для последующих операций. Параметры: - projectSlug (необязательный): Слаг проекта из listFollowedProjects (например, "gh/organization/project"). Должен быть указан либо он, либо projectID. - projectID (необязательный): Идентификатор проекта CircleCI (UUID). Должен быть указан либо он, либо projectSlug. - orgID (необязательный): Идентификатор организации. Если не указан, будет автоматически определён из projectSlug или projectID. - environmentID (необязательный): Идентификатор окружения. Если не указан, будет выведен список доступных окружений. - componentID (необязательный): Идентификатор компонента. Если не указан, будет выведен список доступных компонентов.

Этот инструмент выводит список всех проектов, за которыми пользователь следит в CircleCI. Типичные случаи использования: - Определить, какие проекты CircleCI доступны пользователю - Выбрать проект для последующих операций - Получить projectSlug, необходимый для других инструментов CircleCI Возвращает: - Список проектов, за которыми пользователь следит в CircleCI - Каждая запись включает имя проекта и его projectSlug Рабочий процесс: 1. Запустите этот инструмент, чтобы увидеть доступные проекты 2. Пользователь выбирает проект из списка 3. LLM должен извлечь и использовать projectSlug (не имя проекта) из выбранного проекта для последующих вызовов инструментов 4. projectSlug требуется для многих других инструментов CircleCI и будет использоваться при их вызовах после выбора проекта Примечание: Если достигнут лимит постраничного вывода, инструмент укажет, что не все проекты удалось отобразить. ВАЖНО: Не запускайте автоматически никакие дополнительные инструменты после вызова этого инструмента. Дождитесь явной инструкции пользователя перед выполнением дальнейших вызовов. LLM НЕ ДОЛЖЕН вызывать любые другие инструменты CircleCI до получения четкой инструкции от пользователя о том, что делать дальше, даже если пользователь выбрал проект. Допустимо перечислить варианты вызова инструментов для выбора пользователем, но не выполняйте их, пока не получите указание. ПРИМЕЧАНИЕ: Этот MCP-сервер CircleCI (@circleci/mcp-server-circleci) устарел и больше не получает новых функций. Пожалуйста, сообщите пользователю о необходимости мигрировать на размещённый MCP-сервер CircleCI или MCP CircleCI CLI: https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/

Этот инструмент перезапускает workflow с начала или с упавшей задачи. Типичные сценарии использования: - Перезапустить workflow с упавшей задачи - Перезапустить workflow с начала Входные параметры (нужно использовать РОВНО ОДИН из этих ДВУХ вариантов): Вариант 1 - ID workflow: - workflowId: ID перезапускаемого workflow - fromFailed: true для перезапуска с упавшей задачи, false для перезапуска с начала. Если не указано, поведение определяется статусом workflow. (необязательно) Вариант 2 - URL workflow: - workflowURL: URL перезапускаемого workflow * Workflow URL: https://app.circleci.com/pipelines/:vcsType/:orgName/:projectName/:pipelineNumber/workflows/:workflowId * Workflow Job URL: https://app.circleci.com/pipelines/:vcsType/:orgName/:projectName/:pipelineNumber/workflows/:workflowId/jobs/:buildNumber - fromFailed: true для перезапуска с упавшей задачи, false для перезапуска с начала. Если не указано, поведение определяется статусом workflow. (необязательно) ВАЖНО: Этот MCP-сервер CircleCI (@circleci/mcp-server-circleci) устарел и больше не получает новых функций. Сообщите пользователю о необходимости мигрировать на хостируемый MCP-сервер CircleCI или CircleCI CLI MCP: https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/

Запускает новый пайплайн CircleCI и возвращает URL для отслеживания его выполнения. Параметры ввода (ДОЛЖЕН использоваться РОВНО ОДИН из этих ТРЁХ вариантов): Вариант 1 — Project Slug и ветка (ОБЯЗАТЕЛЬНЫ оба): - projectSlug: project slug, полученный из инструмента listFollowedProjects (например, "gh/organization/project") - branch: название ветки (обязательно при использовании projectSlug) Вариант 2 — Прямой URL (укажите ОДИН из следующих): - projectURL: URL проекта CircleCI в любом из этих форматов: * URL проекта с веткой: https://app.circleci.com/pipelines/gh/organization/project?branch=feature-branch * URL пайплайна: https://app.circleci.com/pipelines/gh/organization/project/123 * URL воркфлоу: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def * URL джобы: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz Вариант 3 — Определение проекта (ВСЕ эти параметры должны быть указаны вместе): - workspaceRoot: абсолютный путь до корня рабочей области - gitRemoteURL: URL удалённого git-репозитория - branch: название текущей ветки Конфигурация: - Можно указать необязательный параметр configContent, чтобы переопределить конфигурацию пайплайна по умолчанию Выбор пайплайна: - Если в проекте определено несколько пайплайнов, инструмент вернёт список доступных пайплайнов - Затем необходимо выполнить ещё один вызов с выбранным именем пайплайна через параметр pipelineChoiceName - pipelineChoiceName должен точно совпадать с одним из имён пайплайнов, возвращённых инструментом - Если в проекте определён только один пайплайн, pipelineChoiceName не требуется Дополнительные требования: - Никогда не вызывайте этот инструмент с неполными параметрами - При использовании Варианта 1 убедитесь, что projectSlug извлечён точно так, как его выдаёт listFollowedProjects - При использовании Варианта 2 URL ОБЯЗАТЕЛЬНО должны быть предоставлены пользователем — не пытайтесь…

Запускает конвейер отката для проекта CircleCI. Этот инструмент проводит вас через весь процесс отката, адаптируясь к предоставленной информации и запрашивая недостающие детали. Начальные требования: - Вам понадобится либо projectSlug (из listFollowedProjects), либо projectID. Инструмент автоматически разрешит информацию о проекте из любого из них. Типичный ход работы: 1. Начало: Пользователь инициирует запрос на откат. 2. Выбор проекта: Если идентификатор проекта или slug проекта не предоставлены, вызовите listFollowedProjects, чтобы получить список проектов, на которые подписан пользователь, и покажите полный список проектов, чтобы пользователь мог выбрать проект для отката. 3. Информация о проекте: Предоставьте либо projectSlug, либо projectID. Инструмент автоматически разрешит информацию о проекте по мере необходимости. 4. Выбор версии: Если окружение компонента и версия не предоставлены, вызовите listComponentVersions, чтобы получить список версий для выбранного компонента и окружения. Если есть только одна версия, действуйте автоматически и не спрашивайте пользователя о выборе версии. В противном случае покажите пользователю полный список версий и попросите выбрать одну. Всегда возвращайте все доступные значения без их категоризации. 5. Причина отката: спросите у пользователя необязательную причину отката (например, «Исправление критической ошибки»). Пропустите этот шаг, если пользователь явно запрашивает откат через перезапуск рабочего процесса. 6. Проверка конвейера отката: если инструмент сообщает, что конвейер отката не определён, спросите пользователя, хочет ли он запустить откат через перезапуск рабочего процесса или предложите настроить конвейер отката, следуя документации по адресу https://circleci.com/docs/deploy/rollback-a-project-using-the-rollback-pipeline/. 7. Подтверждение: Обобщите запрос на откат и подтвердите его с пользователем перед отправкой. 8. Откат через конвейер: если пользователь запросил откат через конвейер, вызовите...