阿里云云效 DevOps MCP Server#

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

渐进式披露模式#

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

查看工具列表和参数#

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

bash

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

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

bash

npx -y mcporter list yunxiao --schema

调用工具#

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

bash

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

示例：

bash

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

环境变量配置#

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

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

可通过 --env 参数传递：

bash

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. 代码审查工作流#

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

bash

# 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. 流水线运行工作流#

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

bash

# 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. 项目管理工作流#

创建工作项并跟踪进度：

bash

# 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 文档