AlibabaCloud DevOps MCP

English | 中文

alibabacloud-devops-mcp-server

AlibabaCloud Devops MCP Server предоставляет AI-ассистентам возможность взаимодействовать с платформой Yunxiao, позволяя читать содержимое рабочих элементов в проектах, автоматически писать код после понимания требований и отправлять запросы на слияние кода. Корпоративные команды разработки могут использовать его для помощи в ревью кода, оптимизации управления задачами, сокращения повторяющихся операций и, таким образом, сосредоточиться на более важных инновациях и поставке продукта.

Возможности

alibabacloud-devops-mcp-server предоставляет AI-ассистентам следующие возможности:

• organization-management: Инструменты управления организацией (список организаций, детали организации, информация о подразделениях, организационные роли, информация о членах и т.д.)
• code-management: Инструменты управления репозиториями кода (управление репозиториями, управление ветками, управление запросами на слияние, дерево файлов и т.д.)
• project-management: Инструменты управления проектами (управление проектами, управление рабочими элементами, поля рабочих элементов, комментарии к рабочим элементам, отслеживание времени и т.д.)
• pipeline-management: Инструменты управления конвейерами (список конвейеров, конфигурация конвейеров, управление ресурсами, управление тегами, управление развертыванием и т.д.)
• application-delivery: Инструменты доставки приложений (управление заказами на развертывание, управление приложениями, теги приложений, управление группами переменных и т.д.)
• packages-management: Инструменты управления репозиториями артефактов (репозитории артефактов, списки артефактов и т.д.)
• test-management: Инструменты управления тестированием (управление тестовыми сценариями, каталоги тестовых сценариев, тестовые планы, результаты тестов и т.д.)

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

Поддержка региональных изданий

Этот инструмент поддерживает как центральную станцию Yunxiao, так и режимы развертывания региональных изданий:

• Центральная станция: Использует https://openapi-rdc.aliyuncs.com в качестве домена API
• Региональное издание: Использует домены, специфичные для организации, например https://your-org.devops.aliyuncs.com

Автоматическое определение режима

Инструмент автоматически определяет режим развертывания на основе настроенного базового URL API:

• Если URL содержит openapi-rdc.aliyuncs.com, он работает в режиме центральной станции
• В противном случае он работает в режиме регионального издания

Настройка регионального издания

При использовании регионального издания установите переменную окружения YUNXIAO_API_BASE_URL:

{
  "mcpServers": {
    "yunxiao": {
      "command": "npx",
      "args": ["-y", "alibabacloud-devops-mcp-server"],
      "env": {
        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "YUNXIAO_API_BASE_URL": "https://your-org.devops.aliyuncs.com"
      }
    }
  }
}

Предварительные требования

• node версии >= 18.0.0

• AlibabaCloud Devops Персональный токен доступа, нажмите здесь, чтобы получить. Предоставьте права на чтение и запись для всех API в рамках управления организацией, совместной работы над проектами, управления кодом, управления конвейерами, управления репозиториями артефактов, доставки приложений и управления тестированием.

  

Официальный размещенный MCP-сервис (без установки)

Yunxiao предоставляет официально размещенную конечную точку MCP — не требуется локальная установка или Docker. Просто укажите на нее в вашем клиенте и аутентифицируйтесь с помощью вашего токена Yunxiao.

• Центральная станция: https://openapi-rdc.aliyuncs.com/ai/mcp
• Региональное издание: домен региона вашей организации + /ai/mcp, например https://<your-org>.devops.aliyuncs.com/ai/mcp — тот же домен, который вы используете для доступа к Yunxiao в вашем регионе.
• Транспорт: Streamable HTTP (без сохранения состояния)
• Аутентификация: Authorization: Bearer <YOUR_TOKEN> (или заголовок X-Yunxiao-Token: <YOUR_TOKEN>)

Конфигурация клиента — Центральная станция (клиенты с нативной поддержкой удаленного доступа, например Cursor):

{
  "mcpServers": {
    "yunxiao": {
      "url": "https://openapi-rdc.aliyuncs.com/ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Конфигурация клиента — Региональное издание (замените URL на домен вашего региона):

{
  "mcpServers": {
    "yunxiao": {
      "url": "https://<your-org>.devops.aliyuncs.com/ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Совет: сократите использование контекста, запрашивая только нужные наборы инструментов — ?toolsets=code-management,project-management или заголовок X-Devops-Toolsets. См. полное руководство: docs/hosted-mcp-guide.zh-CN.md.

---

Быстрый старт (самостоятельное размещение, режим Stdio)

Режим Stdio — это самый простой способ самостоятельного размещения, подходящий для большинства MCP-клиентов (таких как Cursor, Claude Desktop, iFlow и т.д.). Установка Docker не требуется, просто запустите через npx.

Вариант 1: Прямое использование через NPX (самый простой)

Добавьте следующую конфигурацию в файл конфигурации вашего MCP-клиента:

{
  "mcpServers": {
    "yunxiao": {
      "command": "npx",
      "args": [
        "-y",
        "alibabacloud-devops-mcp-server"
      ],
      "env": {
        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Примечание:

• Замените <YOUR_TOKEN> на ваш токен доступа Yunxiao
• Флаг -y автоматически подтверждает установку без ручного подтверждения
• По умолчанию инструмент вызывает OpenAPI центральной станции Yunxiao (https://openapi-rdc.aliyuncs.com); дополнительная настройка не требуется
• Если вы используете региональное издание (домен, специфичный для организации), установите дополнительную переменную окружения YUNXIAO_API_BASE_URL на URL вашего экземпляра Yunxiao, например https://your-org.devops.aliyuncs.com. См. раздел Настройка регионального издания выше для подробностей
• Этот метод использует режим stdio, взаимодействуя с MCP-клиентом через стандартный ввод/вывод

---

Использование Docker (опционально)

Режимы транспорта

Режим	Флаг CLI	Переменная окружения	Конечные точки
Stdio	(по умолчанию)	—	stdin/stdout
SSE	--sse	MCP_TRANSPORT=sse	/sse + /messages
Streamable HTTP	--streamable-http	MCP_TRANSPORT=streamable-http	/mcp
Оба	--sse --streamable-http	MCP_TRANSPORT=both	/sse + /mcp

Streamable HTTP — это рекомендуемый удаленный транспорт по спецификации MCP. SSE устарел; используйте both во время миграции.

1. Загрузка образа

docker pull build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest

Самостоятельная сборка: docker build -t alibabacloud/alibabacloud-devops-mcp-server .

2. Запуск сервера

Stdio:

docker run -i --rm -e YUNXIAO_ACCESS_TOKEN \
  build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest

SSE / Streamable HTTP / Оба — установите MCP_TRANSPORT и откройте PORT:

docker run -d --name yunxiao-mcp -p 3000:3000 \
  -e YUNXIAO_ACCESS_TOKEN="your_token" -e PORT=3000 \
  -e MCP_TRANSPORT=streamable-http \   # sse | streamable-http | both
  build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest

Дополнительные переменные окружения Streamable HTTP:

• MCP_STREAMABLE_PATH: Путь конечной точки MCP (по умолчанию /mcp)
• MCP_HTTP_HOST: Хост привязки (по умолчанию 0.0.0.0)
• MCP_ALLOWED_HOSTS: Разрешенные значения заголовка Host (через запятую)

3. Настройка MCP-клиента

Stdio:

{
  "mcpServers": {
    "yunxiao": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "YUNXIAO_ACCESS_TOKEN", "build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest"],
      "env": { "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>" }
    }
  }
}

SSE: http://localhost:3000/sse

Streamable HTTP: http://localhost:3000/mcp

Передайте учетные данные через параметр запроса или заголовок:

http://localhost:3000/mcp?yunxiao_access_token=YOUR_TOKEN_HERE

Или через заголовок запроса: x-yunxiao-token: YOUR_TOKEN_HERE

Базовый URL OpenAPI региона / экземпляра:

http://localhost:3000/mcp?yunxiao_access_token=TOKEN&yunxiao_api_base_url=https%3A%2F%2Fyour-org.devops.aliyuncs.com

Или через заголовок запроса: x-yunxiao-api-base-url: https://your-org.devops.aliyuncs.com

Docker Compose

cp .env.example .env   # set YUNXIAO_ACCESS_TOKEN
docker compose up -d

URL клиента: http://localhost:3000/sse (SSE) или http://localhost:3000/mcp (Streamable HTTP)

Наборы инструментов

Сервер теперь поддерживает наборы инструментов, позволяя включать только нужные вам инструменты. Это может уменьшить количество инструментов, представленных AI-ассистенту, и повысить производительность.

Доступные наборы инструментов:

• organization-management: Инструменты управления организацией (список организаций, детали организации, информация о подразделениях, организационные роли, информация о членах и т.д.)
• code-management: Инструменты управления репозиториями кода (управление репозиториями, управление ветками, управление запросами на слияние, дерево файлов и т.д.)
• project-management: Инструменты управления проектами (управление проектами, управление рабочими элементами, поля рабочих элементов, комментарии к рабочим элементам, отслеживание времени и т.д.)
• pipeline-management: Инструменты управления конвейерами (список конвейеров, конфигурация конвейеров, управление ресурсами, управление тегами, управление развертыванием и т.д.)
• packages-management: Инструменты управления репозиториями артефактов (репозитории артефактов, списки артефактов и т.д.)
• application-delivery: Инструменты доставки приложений (управление заказами на развертывание, управление приложениями, теги приложений, управление группами переменных и т.д.)
• test-management: Инструменты управления тестированием (управление тестовыми сценариями, каталоги тестовых сценариев, тестовые планы, результаты тестов и т.д.)

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

1. Через аргумент командной строки:

npx -y alibabacloud-devops-mcp-server --toolsets=code-management,project-management

2. Через переменную окружения:

DEVOPS_TOOLSETS=code-management,project-management npx -y alibabacloud-devops-mcp-server

Если наборы инструментов не указаны, по умолчанию будут включены все инструменты.

Инструменты

alibabacloud-devops-mcp-server включает различные инструменты, в том числе:

Управление организацией

• get_current_organization_Info: Получить информацию об организации текущего пользователя
• get_user_organizations: Получить список организаций, в которые вступил текущий пользователь
• get_organization_role: Получить информацию о роли в организации
• get_organization_departments: Получить список подразделений в организации
• get_organization_department_info: Получить информацию о подразделении в организации
• get_organization_department_ancestors: Получить родительские подразделения подразделения в организации
• get_organization_members: Получить список членов в организации
• get_organization_member_info: Получить информацию о члене в организации
• get_organization_member_info_by_user_id: Получить информацию о члене в организации по идентификатору пользователя
• search_organization_members: Поиск членов организации
• list_organization_roles: Список ролей в организации
• get_organization_role: Получить информацию о роли в организации

Инструменты управления кодом

• create_branch: Создать ветку
• delete_branch: Удалить ветку
• get_branch: Получить информацию о ветке
• list_branches: Получить список веток
• create_file: Создать файл
• delete_file: Удалить файл
• get_file_blobs: Получить содержимое файла
• list_files: Запросить дерево файлов
• update_file: Обновить содержимое файла
• create_change_request: Создать запрос на слияние
• update_change_request: Обновить заголовок или описание запроса на слияние
• create_change_request_comment: Создать комментарий к запросу на слияние
• get_change_request: Запросить запрос на слияние
• list_change_request_patch_sets: Запросить список версий запроса на слияние
• list_change_request: Запросить список запросов на слияние
• list_change_request_comments: Запросить список комментариев к запросу на слияние
• get_compare: Сравнить код
• get_repository: Получить детали репозитория
• list_repositories: Получить список репозиториев
• list_commits: [Управление кодом] Список коммитов в репозитории
• get_commit: [Управление кодом] Получить детали коммита
• create_commit_comment: [Управление кодом] Создать комментарий к коммиту

Инструменты управления проектами

• get_project: Получить детали проекта
• search_projects: Поиск проектов
• get_sprint: Получить детали спринта
• list_sprints: Список спринтов в проекте
• create_sprint: [Управление проектами] Создать спринт
• update_sprint: [Управление проектами] Обновить спринт
• search_programs: [Управление проектами] Поиск программ
• list_program_versions: [Управление проектами] Список версий программы
• list_versions: [Управление проектами] Список версий проекта
• create_version: [Управление проектами] Создать версию
• update_version: [Управление проектами] Обновить версию
• delete_version: [Управление проектами] Удалить версию
• get_work_item: Получить детали рабочего элемента
• update_work_item: [Управление проектами] Обновить рабочий элемент
• search_workitems: Поиск рабочих элементов
• get_work_item_types: Получить типы рабочих элементов
• create_work_item: Создать рабочий элемент
• list_all_work_item_types: Список всех типов рабочих элементов в организации
• list_work_item_types: Список типов рабочих элементов в пространстве проекта
• get_work_item_type: Получить детали конкретного типа рабочего элемента
• list_work_item_relation_work_item_types: Список типов рабочих элементов, которые можно связать с конкретным рабочим элементом
• list_workitem_relation_records: Список записей связей для рабочего элемента
• create_workitem_relation_record: Связать один рабочий элемент с другим
• delete_workitem_relation_record: Удалить связь рабочего элемента
• get_work_item_type_field_config: Получить конфигурацию полей для конкретного типа рабочего элемента
• get_work_item_workflow: Получить информацию о workflow для конкретного типа рабочего элемента
• list_work_item_comments: Список комментариев для конкретного рабочего элемента
• create_work_item_comment: Создать комментарий для конкретного рабочего элемента
• list_workitem_attachments: Список вложений для конкретного рабочего элемента
• get_workitem_file: Получить информацию о файле вложения конкретного рабочего элемента
• create_workitem_attachment: Загрузить локальный файл как вложение к рабочему элементу
• list_workitem_activities: Список истории активности для рабочего элемента (изменения полей, переходы статусов, изменения связей)
• list_current_user_effort_records: [Управление проектами] Получить детали фактических трудозатрат пользователя, интервал между временем окончания и временем начала не может превышать 6 месяцев
• list_effort_records: [Управление проектами] Получить детали фактических трудозатрат
• create_effort_record: [Управление проектами] Зарегистрировать фактические трудозатраты
• list_estimated_efforts: [Управление проектами] Получить детали запланированных трудозатрат
• create_estimated_effort: [Управление проектами] Зарегистрировать запланированные трудозатраты
• update_effort_record: [Управление проектами] Обновить зарегистрированные фактические трудозатраты
• update_estimated_effort: [Управление проектами] Обновить зарегистрированные запланированные трудозатраты

Инструменты управления конвейерами

• get_pipeline: Получить сведения о конвейере
• list_pipelines: Получить список конвейеров
• smart_list_pipelines: Умный поиск конвейеров с естественно-языковыми временными ссылками
• generate_pipeline_yaml: [Управление конвейерами] Сгенерировать YAML-конфигурацию конвейера
• create_pipeline_from_description: Создать конвейер из описания на естественном языке
• update_pipeline: [Управление конвейерами] Обновить YAML-содержимое конвейера
• create_pipeline_run: Создать экземпляр запуска конвейера
• get_latest_pipeline_run: Получить последний экземпляр запуска конвейера
• get_pipeline_run: Получить сведения о запуске конвейера
• list_pipeline_runs: Получить список запусков конвейера
• list_pipeline_jobs_by_category: Получить задачи выполнения конвейера по категориям
• list_pipeline_job_historys: Получить историю выполнения задачи конвейера
• execute_pipeline_job_run: Запустить задачу конвейера вручную
• get_pipeline_job_run_log: Получить журналы выполнения задания конвейера
• list_service_connections: Список сервисных подключений в организации
• create_pipeline_from_description: Автоматически генерирует YAML-конфигурацию и создает конвейер
• update_pipeline: Обновить существующий конвейер в Yunxiao по pipelineId. Используйте это для обновления YAML конвейера, этапов, заданий и т. д.
• create_resource_member: Создать участника ресурса
• delete_resource_member: Удалить участника ресурса
• list_resource_members: Получить список участников ресурса
• update_resource_member: Обновить участника ресурса
• update_resource_owner: Передать владельца ресурса
• create_tag: Создать тег
• create_tag_group: Создать группу тегов
• list_tag_groups: Получить список групп тегов
• delete_tag_group: Удалить группу тегов
• update_tag_group: Обновить группу тегов
• get_tag_group: Получить группу тегов
• delete_tag: Удалить тег
• update_tag: Обновить тег
• stop_vm_deploy_order: Остановить заказ развертывания VM
• skip_vm_deploy_machine: Пропустить машину развертывания VM
• retry_vm_deploy_machine: Повторить машину развертывания VM
• resume_vm_deploy_order: Возобновить заказ развертывания VM
• get_vm_deploy_order: Получить сведения о заказе развертывания VM
• get_vm_deploy_machine_log: Получить журнал машины развертывания VM

Инструменты доставки приложений

• create_change_order: [доставка приложений] Создать заказ на развертывание
• list_change_order_versions: [доставка приложений] Просмотреть список версий заказа на развертывание
• get_change_order: [доставка приложений] Прочитать материалы и статус заявок, используемые в заказе на развертывание
• list_change_order_job_logs: [доставка приложений] Запросить журналы заказа на развертывание среды
• find_task_operation_log: [доставка приложений] Запросить журналы выполнения задачи развертывания, которые обычно содержат детали планирования нижестоящего движка развертывания
• execute_job_action: [доставка приложений] Управлять заказом на развертывание среды
• list_change_orders_by_origin: [доставка приложений] Запросить заказы на развертывание по источнику создания
• create_appstack_change_request: [доставка приложений] Создать запрос на изменение
• get_appstack_change_request_audit_items: [доставка приложений] Получить элементы согласования запроса на изменение
• list_appstack_change_request_executions: [доставка приложений] Перечислить записи выполнения запроса на изменение
• list_appstack_change_request_work_items: [доставка приложений] Перечислить рабочие элементы запроса на изменение
• cancel_appstack_change_request: [доставка приложений] Отменить запрос на изменение
• close_appstack_change_request: [доставка приложений] Закрыть запрос на изменение
• list_applications: [доставка приложений] Список приложений в организации с постраничной навигацией
• get_application: [доставка приложений] Получить сведения о приложении по имени
• create_application: [доставка приложений] Создать новое приложение
• update_application: [доставка приложений] Обновить существующее приложение
• get_latest_orchestration: [доставка приложений] Получить последнюю оркестрацию для среды
• list_app_orchestration: [доставка приложений] Перечислить оркестрации приложения
• create_app_orchestration: [доставка приложений] Создать оркестрацию приложения
• delete_app_orchestration: [доставка приложений] Удалить оркестрацию приложения
• get_app_orchestration: [доставка приложений] Получить оркестрацию приложения
• update_app_orchestration: [доставка приложений] Обновить оркестрацию приложения
• get_env_variable_groups: [доставка приложений] Получить группы переменных для среды
• create_variable_group: [доставка приложений] Создать группу переменных
• delete_variable_group: [доставка приложений] Удалить группу переменных
• get_variable_group: [доставка приложений] Получить группу переменных
• update_variable_group: [доставка приложений] Обновить группу переменных
• get_app_variable_groups: [доставка приложений] Получить группы переменных для приложения
• get_app_variable_groups_revision: [доставка приложений] Получить ревизию групп переменных для приложения
• search_app_templates: [доставка приложений] Поиск шаблонов приложений
• create_app_tag: [доставка приложений] Создать тег приложения
• update_app_tag: [доставка приложений] Обновить тег приложения
• search_app_tags: [доставка приложений] Поиск тегов приложения
• update_app_tag_bind: [доставка приложений] Обновить привязки тегов приложения
• create_global_var: [доставка приложений] Создать глобальную группу переменных
• get_global_var: [доставка приложений] Получить глобальную группу переменных
• update_global_var: [доставка приложений] Обновить глобальную группу переменных
• list_global_vars: [доставка приложений] Перечислить глобальные группы переменных
• get_machine_deploy_log: [доставка приложений] Получить журнал развертывания машины
• add_host_list_to_host_group: [доставка приложений] Добавить список хостов в группу хостов
• add_host_list_to_deploy_group: [доставка приложений] Добавить список хостов в группу развертывания
• list_app_release_workflows: [доставка приложений] Перечислить все рабочие процессы выпуска для приложения
• list_app_release_workflow_briefs: [доставка приложений] Перечислить краткие сведения о рабочих процессах выпуска для приложения
• list_system_release_workflows: [доставка приложений] Перечислить все системные рабочие процессы выпуска
• create_system_release_workflow: [доставка приложений] Создать системный рабочий процесс выпуска
• update_system_release_stage: [доставка приложений] Обновить этап системного рабочего процесса выпуска
• execute_system_release_stage: [доставка приложений] Выполнить этап системного рабочего процесса выпуска
• get_app_release_workflow_stage: [доставка приложений] Получить сведения об этапе рабочего процесса выпуска
• list_app_release_stage_briefs: [доставка приложений] Перечислить краткие сведения об этапах выпуска
• update_app_release_stage: [доставка приложений] Обновить этап рабочего процесса выпуска приложения
• list_app_release_stage_runs: [доставка приложений] Перечислить записи выполнения этапов выпуска
• execute_app_release_stage: [доставка приложений] Выполнить этап рабочего процесса выпуска для запроса на изменение
• cancel_app_release_stage_execution: [доставка приложений] Отменить выполнение этапа рабочего процесса выпуска
• retry_app_release_stage_pipeline: [доставка приложений] Повторить конвейер этапа рабочего процесса выпуска
• skip_app_release_stage_pipeline: [доставка приложений] Пропустить конвейер этапа рабочего процесса выпуска
• list_app_release_stage_metadata: [доставка приложений] Перечислить интегрированные метаданные для выполнения этапа
• get_app_release_stage_pipeline_run: [доставка приложений] Получить экземпляр запуска конвейера этапа выпуска
• pass_app_release_stage_validate: [доставка приложений] Пройти проверку этапа рабочего процесса выпуска
• get_app_release_stage_job_log: [доставка приложений] Получить журнал выполнения задания конвейера
• refuse_app_release_stage_validate: [доставка приложений] Отклонить проверку этапа рабочего процесса выпуска

Инструменты управления пакетами

• list_package_repositories: Получить список сведений о репозиториях пакетов
• list_artifacts: Получить список сведений об артефактах
• get_artifact: Получить сведения об одном артефакте

Инструменты управления тестированием

• list_testcase_directories: [управление тестированием] Получить список каталогов тестовых случаев
• create_testcase_directory: [управление тестированием] Создать каталог тестовых случаев
• get_testcase_field_config: [управление тестированием] Получить конфигурацию полей тестовых случаев
• create_testcase: [управление тестированием] Создать тестовый случай
• search_testcases: [управление тестированием] Поиск тестовых случаев
• get_testcase: [управление тестированием] Получить информацию о тестовом случае
• delete_testcase: [управление тестированием] Удалить тестовый случай
• list_test_plans: [управление тестированием] Получить список тестовых планов
• get_test_result_list: [управление тестированием] Получить список тестовых случаев в тестовом плане
• update_test_result: [управление тестированием] Обновить результат теста

Свяжитесь с нами

Если у вас есть вопросы, присоединяйтесь к группе DingTalk «云效mcp server&智能化用户沟通2群» (ID: 177120034028).

Связанные ссылки

• AlibabaCloud DevOps
• MCP market
• Примеры использования
• 使用云效进行项目管理
• 使用云效进行代码管理