alibabacloud-devops

name	alibabacloud-devops
description	阿里云云效 DevOps 平台 MCP Server，提供代码管理、项目管理、流水线、应用交付、测试管理等全面的 DevOps 能力 Use when this capability is needed.
metadata	{"author":"aliyun"}

阿里云云效 DevOps MCP Server

这是阿里云云效 DevOps 平台的 MCP Server Skill，提供全面的 DevOps 工具集，包括代码管理、项目管理、流水线管理、应用交付、制品管理和测试管理等能力。

渐进式披露模式

本 Skill 采用渐进式披露模式，按需获取工具详情和调用工具。

查看工具列表和参数

获取所有工具及其详细参数信息：

npx -y mcporter list --stdio "npx -y alibabacloud-devops-mcp-server" --schema

如果已配置服务器，也可以直接使用：

npx -y mcporter list yunxiao --schema

调用工具

使用 key:value 或 key=value 格式传递参数：

npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" <tool_name> param1:"value1" param2:"value2"

示例：

npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" list_repositories organizationId:"your-org-id"

环境变量配置

MCP Server 需要配置以下环境变量：

• YUNXIAO_ACCESS_TOKEN: 云效访问令牌（必需）

可通过 --env 参数传递：

npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" --env YUNXIAO_ACCESS_TOKEN=your-token <tool_name> ...

---

工具列表

共 165 个工具，按功能分类如下：

基础工具（Base）

工具名	描述
get_current_organization_info	获取当前用户和组织信息（基于 token）
get_user_organizations	获取当前用户所属的组织列表
get_current_user	获取当前用户信息（基于 token）

代码管理（Code Management）

分支管理

工具名	描述
create_branch	创建代码仓库分支
get_branch	获取分支信息
delete_branch	删除分支
list_branches	列出仓库所有分支

文件操作

工具名	描述
get_file_blobs	获取文件内容
create_file	创建新文件
update_file	更新文件内容
delete_file	删除文件
list_files	列出目录下的文件
compare	代码比较

仓库管理

工具名	描述
get_repository	获取仓库详情
list_repositories	列出代码仓库

变更请求（Merge Request）

工具名	描述
get_change_request	获取变更请求详情
list_change_requests	列出变更请求
create_change_request	创建变更请求
create_change_request_comment	创建变更请求评论
list_change_request_comments	列出变更请求评论
update_change_request_comment	更新变更请求评论
list_change_request_patch_sets	列出变更请求的补丁集

提交记录

工具名	描述
list_commits	列出提交记录
get_commit	获取提交详情
create_commit_comment	创建提交评论

组织管理（Organization）

部门管理

工具名	描述
list_organization_departments	列出组织部门
get_organization_department_info	获取部门信息
get_organization_department_ancestors	获取部门的上级部门链

成员管理

工具名	描述
list_organization_members	列出组织成员
get_organization_member_info	获取成员信息
get_organization_member_info_by_user_id	通过用户 ID 获取成员信息
search_organization_members	搜索组织成员

角色管理

工具名	描述
list_organization_roles	列出组织角色
get_organization_role	获取角色详情

项目管理（Project Management）

项目与项目集

工具名	描述
get_project	获取项目详情
search_projects	搜索项目
search_programs	搜索项目集
list_program_versions	列出项目集版本

版本管理

工具名	描述
list_versions	列出版本
create_version	创建版本
update_version	更新版本
delete_version	删除版本

迭代管理

工具名	描述
get_sprint	获取迭代详情
list_sprints	列出迭代
create_sprint	创建迭代
update_sprint	更新迭代

工作项管理

工具名	描述
get_work_item	获取工作项详情
create_work_item	创建工作项
search_workitems	搜索工作项
update_work_item	更新工作项
get_work_item_types	获取工作项类型列表
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_current_user_effort_records	列出当前用户的工时记录
list_effort_records	列出工时记录
create_effort_record	创建工时记录
update_effort_record	更新工时记录
list_estimated_efforts	列出预估工时
create_estimated_effort	创建预估工时
update_estimated_effort	更新预估工时

流水线管理（Pipeline）

流水线基础操作

工具名	描述
get_pipeline	获取流水线详情
list_pipelines	列出流水线
smart_list_pipelines	智能搜索流水线（支持自然语言时间）
update_pipeline	更新流水线配置

流水线生成

工具名	描述
generate_pipeline_yaml	生成流水线 YAML 配置
create_pipeline_from_description	根据描述创建流水线

流水线运行

工具名	描述
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	列出服务连接

资源成员管理（Resource Member）

工具名	描述
list_resource_members	列出资源成员
create_resource_member	添加资源成员
update_resource_member	更新资源成员
delete_resource_member	删除资源成员
update_resource_owner	转让资源所有者

主机部署（VM Deploy）

工具名	描述
get_vm_deploy_order	获取主机部署单详情
stop_vm_deploy_order	停止主机部署
resume_vm_deploy_order	恢复主机部署
skip_vm_deploy_machine	跳过指定机器部署
retry_vm_deploy_machine	重试指定机器部署
get_vm_deploy_machine_log	获取机器部署日志

制品管理（Packages）

工具名	描述
list_package_repositories	列出制品仓库
list_artifacts	列出制品
get_artifact	获取制品详情

应用交付（Application Delivery）

应用管理

工具名	描述
list_applications	列出应用
get_application	获取应用详情
create_application	创建应用
update_application	更新应用

应用标签

工具名	描述
create_app_tag	创建应用标签
update_app_tag	更新应用标签
search_app_tags	搜索应用标签
update_app_tag_bind	更新应用标签绑定

应用模板

工具名	描述
search_app_templates	搜索应用模板

全局变量

工具名	描述
create_global_var	创建全局变量组
get_global_var	获取全局变量组
update_global_var	更新全局变量组
list_global_vars	列出全局变量组

变量组管理

工具名	描述
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	获取应用变量组版本

编排管理

工具名	描述
get_latest_orchestration	获取最新编排
list_app_orchestration	列出应用编排
create_app_orchestration	创建应用编排
delete_app_orchestration	删除应用编排
get_app_orchestration	获取应用编排
update_app_orchestration	更新应用编排

变更请求

工具名	描述
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	关闭变更请求

部署管理

工具名	描述
get_machine_deploy_log	获取机器部署日志
add_host_list_to_host_group	添加主机到主机组
add_host_list_to_deploy_group	添加主机到部署组

部署单管理

工具名	描述
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	根据来源查询部署单

发布流程管理

工具名	描述
list_app_release_workflows	查询应用发布流程
list_app_release_workflow_briefs	查询发布流程摘要
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	拒绝发布阶段验证

测试管理（Test Management）

测试用例

工具名	描述
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	更新测试结果

---

常见工作流示例

1. 代码审查工作流

查看待审核的变更请求并添加评论：

# 1. 获取当前组织信息
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" get_current_organization_info

# 2. 列出待审核的变更请求
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" list_change_requests organizationId:"your-org-id" repositoryId:"your-repo-id" state:"opened"

# 3. 获取变更请求详情
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" get_change_request organizationId:"your-org-id" repositoryId:"your-repo-id" localId:"123"

# 4. 添加审查评论
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" create_change_request_comment organizationId:"your-org-id" repositoryId:"your-repo-id" localId:"123" commentType:"GLOBAL_COMMENT" content:"LGTM! Code looks good."

2. 流水线运行工作流

运行流水线并查看执行结果：

# 1. 列出可用的流水线
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" list_pipelines organizationId:"your-org-id"

# 2. 运行流水线（使用指定分支）
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" create_pipeline_run organizationId:"your-org-id" pipelineId:"123456" branch:"main"

# 3. 获取最近一次运行状态
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" get_latest_pipeline_run organizationId:"your-org-id" pipelineId:"123456"

# 4. 查看任务执行日志
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" get_pipeline_job_run_log organizationId:"your-org-id" pipelineId:"123456" pipelineRunId:"789" jobId:"job-1"

3. 项目管理工作流

创建工作项并跟踪进度：

# 1. 搜索项目
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" search_projects organizationId:"your-org-id" keyword:"my-project"

# 2. 创建工作项（需求/任务/缺陷）
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" create_work_item organizationId:"your-org-id" workitemTypeId:"type-id" subject:"实现新功能"

# 3. 搜索工作项
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" search_workitems organizationId:"your-org-id" projectId:"project-id"

# 4. 更新工作项状态
npx -y mcporter call --stdio "npx -y alibabacloud-devops-mcp-server" update_work_item organizationId:"your-org-id" workitemId:"workitem-id" updateType:"STATUS"

---

相关资源

• 云效官方文档
• 云效 API 文档

---

Source: aliyun/alibabacloud-devops-mcp-server — distributed by TomeVault.