CircleCI/mcp-server-circleci

Этот инструмент помогает анализировать, проверять и исправлять файлы конфигурации CircleCI. Параметры: - params: объект, содержащий: - configFile: строка — полное содержимое конфигурационного файла CircleCI в виде строки. Это должен быть сырой YAML-контент, а не путь к файлу. Пример использования: { "params": { "configFile": "version: 2.1 orbs: node: circleci/node@7 ..." } } Примечание: содержимое configFile должно передаваться как правильно экранированная строка с символами новой строки, представленными как . Инструкции по выводу инструмента: - Если конфигурация неверна, инструмент вернёт ошибки и исходную конфигурацию. Используйте ошибки, чтобы исправить конфигурацию. - Если конфигурация верна, ничего не делайте.

⚠️ ОБЯЗАТЕЛЬНО: обработчик ОТКЛОНИТ любой вызов, который не содержит ОБА параметра: outputDir и originalUserMessage. Эти параметры обязательны для всех вызовов инструментов. ⚠️ ОБЯЗАТЕЛЬНЫЙ ВЫБОР ВЫХОДНОЙ ДИРЕКТОРИИ ДЛЯ AI-АГЕНТОВ: 1. Если корень проекта (корень рабочей области) доступен (например, через workspaceRoot или известный контекст репозитория), вы ОБЯЗАНЫ передать его как параметр outputDir. 2. Если корень проекта недоступен, вы ОБЯЗАНЫ использовать папку Загрузки пользователя (например, ~/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 или %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." - Приступай к анализу логов только после подтверждения усечения Варианты ввода (нужно использовать РОВНО ОДИН из этих ТРЁХ вариантов): Вариант 1 - Project Slug: - projectSlug: slug проекта, полученный из инструмента listFollowedProjects (например, "gh/organization/project") Вариант 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 Вариант 3 - Определение проекта (ВСЕ эти параметры должны быть указаны вместе): - workspaceRoot: абсолютный путь к корню рабочей области - gitRemoteURL: URL удалённого git-репозитория Дополнительные требования: - Никогда не вызывай этот инструмент с неполными параметрами - При использовании Варианта 1 обязательно извлеки projectSlug точно так, как его предоставил listFollowedProjects - При использовании Варианта 2 URL ОБЯЗАТЕЛЬНО должны быть предоставлены пользователем — не пытайся конструировать или угадывать URL - При использовании Варианта 3 ОБА параметра (workspaceRoot, gitRemoteURL) должны быть указаны - Если ни один из вариантов нельзя полностью выполнить, спроси у пользователя недостающую информацию

Анализирует CSV-файл с данными об использовании CircleCI и находит задания и классы ресурсов, у которых средняя или максимальная загрузка CPU/RAM ниже заданного порога (по умолчанию 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 (регистронезависимые). Эти обязательные столбцы — подмножество столбцов из вывода API использования CircleCI, инструмент работает с полным набором столбцов из CSV этого API. Возвращает сводный отчёт со списком всех заданий и классов ресурсов, где хотя бы одна из этих метрик ниже порога.

Этот инструмент помогает отлаживать сбои сборок CircleCI, получая журналы ошибок. КРИТИЧЕСКИ ВАЖНО: 1. Обработка больших журналов: - Если вы ожидаете большие журналы или хотите получить полный вывод, укажите outputDir. Полные журналы будут записаны в файл, и вернётся путь к нему. * Используйте корневую папку проекта/воркспейса, если она доступна, иначе папку Downloads (например, "~/Downloads"). - Если outputDir не указан, журналы возвращаются в теле ответа, но могут быть обрезаны. Когда обрезаны, вывод содержит <MCPTruncationWarning>, и вы ОБЯЗАНЫ признать: «ВНИМАНИЕ: Журналы были обрезаны. Показаны только последние записи.» Параметры ввода (нужно использовать РОВНО ОДИН из этих ТРЁХ вариантов): Вариант 1 - Project Slug и ветка (ОБА обязательны): - projectSlug: slug проекта, полученный из инструмента listFollowedProjects (например, "gh/organization/project") - branch: имя ветки (обязательно при использовании projectSlug) Вариант 2 - Прямая ссылка (укажите ОДНУ из): - projectURL: URL проекта CircleCI в любом из форматов: * Проект: https://app.circleci.com/pipelines/gh/organization/project * Pipeline: https://app.circleci.com/pipelines/gh/organization/project/123 * Legacy Job: https://circleci.com/pipelines/gh/organization/project/123 * Workflow: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def * Job: 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' Опции ввода (ДОЛЖНА ИСПОЛЬЗОВАТЬСЯ ТОЛЬКО ОДНА из этих ТРЁХ опций): Option 1 - projectSlug и ветка (ОБЯЗАТЕЛЬНЫ оба): - projectSlug: слаг проекта, полученный из инструмента listFollowedProjects (например, gh/organization/project) - branch: имя ветки (обязательно при использовании projectSlug) Option 2 - прямая ссылка (укажите ОДНУ из них): - projectURL: URL задачи в CircleCI в одном из следующих форматов: * URL задачи: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789 * URL воркфлоу: (продолжение в оригинале, но здесь обрывается)

Этот инструмент получает статус последнего пайплайна для проекта CircleCI. Его можно использовать, чтобы проверить статус пайплайна, получить статус последней сборки или посмотреть текущее состояние пайплайна. Типовые сценарии: - Проверить статус последнего пайплайна - Получить статус текущей сборки - Посмотреть состояние пайплайна - Проверить прогресс сборки - Получить информацию о пайплайне Параметры на вход (должен быть использован РОВНО ОДИН из этих ТРЁХ вариантов): Вариант 1 — Project Slug и ветка (оба обязательны): - projectSlug: идентификатор проекта, полученный из инструмента 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://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 * 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, ссылки ДОЛЖНЫ быть предоставлены пользователем — не пытайтесь…

Этот инструмент получает список артефактов, созданных задачей CircleCI. Типичные сценарии использования: - Посмотреть все артефакты, сгенерированные конкретной задачей - Найти ссылки для скачивания артефактов сборки (бинарники, отчёты, логи и т. д.) - Проверить, какие артефакты были созданы в рамках прогона пайплайна Варианты входных данных (НУЖНО ИСПОЛЬЗОВАТЬ РОВНО ОДИН из этих ТРЁХ вариантов): Вариант 1 – Project Slug и ветка (ОБЯЗАТЕЛЬНЫ ОБА): - projectSlug: идентификатор проекта из инструмента listFollowedProjects (например, "gh/organization/project") - branch: имя ветки (обязательно при использовании projectSlug) Вариант 2 – прямая ссылка (укажите ОДНУ из следующих): - projectURL: ссылка на задачу CircleCI в одном из следующих форматов: * 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 - Если используете вариант 3, нужно передать ВСЕ ТРИ параметра (workspaceRoot, gitRemoteURL, branch) - Если ни один из вариантов не удаётся полностью выполнить, спросите у пользователя недостающую информацию перед вызовом инструмента

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

Этот инструмент выводит список всех проектов, на которые пользователь подписан в CircleCI. Типичные сценарии использования: - Узнать, какие проекты CircleCI доступны пользователю - Выбрать проект для последующих операций - Получить projectSlug, необходимый для других инструментов CircleCI Что возвращает: - Список проектов, на которые пользователь подписан в CircleCI - Каждая запись содержит имя проекта и его projectSlug Порядок работы: 1. Запустите этот инструмент, чтобы увидеть доступные проекты 2. Пользователь выбирает проект из списка 3. LLM извлекает projectSlug (не имя проекта) из выбранного проекта и использует его в последующих вызовах инструментов 4. projectSlug требуется для многих других инструментов CircleCI и будет использоваться в вызовах этих инструментов после выбора проекта Примечание: если достигнут лимит пагинации, инструмент сообщит, что не все проекты удалось отобразить. ВАЖНО: Не запускайте автоматически никакие дополнительные инструменты после вызова этого инструмента. Дождитесь явной инструкции от пользователя, прежде чем выполнять дальнейшие вызовы. LLM НЕ ДОЛЖЕН вызывать другие инструменты CircleCI до получения чёткого указания от пользователя, что делать дальше — даже если пользователь выбрал проект. Допустимо перечислить варианты вызова инструментов для выбора, но не выполняйте их до получения инструкции.

Этот инструмент используется для повторного запуска workflow с начала или с упавшей задачи. Типичные сценарии использования: - Перезапустить workflow с упавшей задачи - Перезапустить workflow с начала Параметры ввода (нужно использовать РОВНО ОДИН из этих ДВУХ вариантов): Вариант 1 - Workflow ID: - workflowId: ID workflow для перезапуска - fromFailed: true — перезапуск с упавшей задачи, false — перезапуск с начала. Если опущено, поведение определяется статусом workflow. (необязательно) Вариант 2 - Workflow URL: - 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. (необязательно)

Этот инструмент запускает новый пайплайн CircleCI и возвращает URL для отслеживания его выполнения. Входные параметры (ОБЯЗАТЕЛЬНО одно из этих ТРЁХ): Вариант 1 — Project Slug и ветка (ОБА обязательны): - projectSlug: слаг проекта, полученный из инструмента 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. Причина отката: Спросите у пользователя необязательную причину отката (например, «Критическое исправление ошибки»). Пропустите этот шаг, если пользователь явно запрашивает откат через повторный запуск workflow. 6. Проверка пайплайна отката: Если инструмент сообщает, что пайплайн отката не определён, спросите пользователя, хочет ли он запустить откат через повторный запуск workflow, или предложите настроить пайплайн отката по документации https://circleci.com/docs/deploy/rollback-a-project-using-the-rollback-pipeline/. 7. Подтверждение: Обобщите запрос на откат и получите подтверждение от пользователя перед отправкой. 8. Откат через пайплайн: Если пользователь запросил откат через пайплайн, вызовите…