AlibabaCloud DevOps MCP
официальныйMCP-сервер Yunxiao предоставляет AI-ассистентам возможность взаимодействовать с платформой Yunxiao.
Что можно делать с Alibaba Cloud Dev Ops MCP?
- Поиск и просмотр рабочих элементов — Находите рабочие элементы в проектах с помощью
search_workitemsи просматривайте их детали, комментарии, вложения и историю активности. - Управление запросами на слияние и кодом — Просматривайте, создавайте и комментируйте запросы на слияние (
list_change_request,create_change_request_comment), просматривайте файловые деревья репозитория и сравнивайте ветки. - Запуск и проверка пайплайнов — Запускайте пайплайны, получайте журналы выполнения и запрашивайте статусы запусков с помощью
list_pipeline_runsиget_pipeline_job_run_log. - Управление развертыванием приложений — Создавайте заказы на изменения развертывания, просматривайте журналы развертывания и управляйте этапами рабочего процесса релиза с помощью
execute_app_release_stage. - Управление тестовыми сценариями и планами — Ищите тестовые сценарии, создавайте тестовые планы и обновляйте результаты тестов с помощью
search_testcasesиupdate_test_result. - Просмотр структуры организации — Ищите отделы, участников и роли с помощью
get_organization_departmentsиsearch_organization_members.
Документация
English | 中文
alibabacloud-devops-mcp-server
AlibabaCloud Devops MCP Server предоставляет ИИ-ассистентам возможность взаимодействовать с платформой Yunxiao, позволяя им читать содержимое рабочих элементов в проектах, автоматически писать код после понимания требований и отправлять запросы на слияние кода. Команды корпоративной разработки могут использовать его для помощи в проверке кода, оптимизации управления задачами, сокращения повторяющихся операций и, таким образом, сосредоточиться на более важных инновациях и поставке продукта.
Возможности
alibabacloud-devops-mcp-server предоставляет ИИ-ассистентам следующие возможности:
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
Базовый 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)
Наборы инструментов
Сервер теперь поддерживает наборы инструментов, позволяя включать только те инструменты, которые вам нужны. Это может сократить количество инструментов, представляемых ИИ-ассистенту, и повысить производительность.
Доступные наборы инструментов:
organization-management: Инструменты управления организацией (список организаций, сведения об организации, информация об отделах, организационные роли, информация об участниках и т. д.)code-management: Инструменты управления репозиториями кода (управление репозиториями, управление ветками, управление запросами на слияние, дерево файлов и т. д.)project-management: Инструменты управления проектами (управление проектами, управление рабочими элементами, поля рабочих элементов, комментарии к рабочим элементам, учет времени и т. д.)pipeline-management: Инструменты управления пайплайнами (список пайплайнов, конфигурация пайплайнов, управление ресурсами, управление тегами, управление развертыванием и т. д.)packages-management: Инструменты управления репозиториями артефактов (репозитории артефактов, списки артефактов и т. д.)application-delivery: Инструменты доставки приложений (управление заказами на развертывание, управление приложениями, теги приложений, управление группами переменных и т. д.)test-management: Инструменты управления тестированием (управление тестовыми случаями, каталоги тестовых случаев, планы тестирования, результаты тестирования и т. д.)
Чтобы использовать наборы инструментов, вы можете указать их через аргументы командной строки или переменные окружения:
- Через аргумент командной строки:
npx -y alibabacloud-devops-mcp-server --toolsets=code-management,project-management
- Через переменную окружения:
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: Создать запрос на слияние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: Список типов рабочих элементов, которые можно связать с конкретным рабочим элементомget_work_item_type_field_config: Получить конфигурацию полей для конкретного типа рабочего элементаget_work_item_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: Остановить заказ на развертывание ВМskip_vm_deploy_machine: Пропустить машину развертывания ВМretry_vm_deploy_machine: Повторить развертывание на машине ВМresume_vm_deploy_order: Возобновить заказ на развертывание ВМget_vm_deploy_order: Получить детали заказа на развертывание ВМget_vm_deploy_machine_log: Получить журнал машины развертывания ВМ
Инструменты доставки приложений
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: [управление тестированием] Обновить результат тестирования
Свяжитесь с нами
Если у вас есть вопросы, присоединяйтесь к дискуссионной группе Alibaba Cloud Devops (134400004101) для обсуждения.
