English | 中文
阿里巴巴云devops mcp服务器
阿里巴巴云开发 MCP Server为AI助手提供了与云霄平台交互的能力，使他们能够读取项目中的工作项内容，在理解需求后自动编写代码，并提交代码合并请求。企业开发团队可以使用它来协助代码审查，优化任务管理，减少重复操作，从而专注于更重要的创新和产品交付。
特性
阿里巴巴云devops mcp服务器为AI助手提供以下功能：
organization-management：组织管理工具（组织列表、组织详细信息、部门信息、组织角色、成员信息等）code-management：代码库管理工具（库管理、分支管理、合并请求管理、文件树等）project-management：项目管理工具（项目管理、工作项管理、工作项目字段、工作项注释、时间跟踪等）pipeline-management：管道管理工具（管道列表、管道配置、资源管理、标签管理、部署管理等）application-delivery：应用交付工具（部署订单管理、应用管理、应用标签、变量组管理等）packages-management：工件存储库管理工具（工件存储库、工件列表等）test-management：测试管理工具（测试用例管理、测试用例目录、测试计划、测试结果等）
用法
区域版本支持
该工具支持云霄中心站和区域版部署模式：
- 中央车站：用途
https://openapi-rdc.aliyuncs.com作为API域 - 地区版本：使用特定于组织的域，例如
https://your-org.devops.aliyuncs.com
自动模式检测
该工具根据配置的API基础URL自动确定部署模式：
- 如果URL包含
openapi-rdc.aliyuncs.com，它以中心站模式运行 - 否则，它将以区域编辑模式运行
配置区域版本
使用区域版本时，设置 YUNXIAO_API_BASE_URL 环境变量：
{
"mcpServers": {
"yunxiao": {
"command": "npx",
"args": ["-y", "alibabacloud-devops-mcp-server"],
"env": {
"YUNXIAO_ACCESS_TOKEN": "",
"YUNXIAO_API_BASE_URL": "https://your-org.devops.aliyuncs.com"
}
}
}
}区域模式下的organizationId参数
在区域模式下 organizationId 参数变为可选：
- 中央车站模式:
organizationId是必需的，必须由用户明确提供 - 区域模式:
organizationId可以省略，系统将自动使用默认值"default"
这意味着在区域模式下，用户不需要担心组织ID——该工具会自动处理它。
先决条件
- 节点版本>=18.0.0
快速入门（推荐：使用标准模式）
标准模式 是最简单、最常见的方法，适用于大多数MCP客户端（如Cursor、Claude Desktop、iFlow等）。无需安装Docker，只需通过npx运行即可。
选项1：通过NPX直接使用（最简单）
将以下配置添加到MCP客户端配置文件中：
{
"mcpServers": {
"yunxiao": {
"command": "npx",
"args": [
"-y",
"alibabacloud-devops-mcp-server"
],
"env": {
"YUNXIAO_ACCESS_TOKEN": "",
"YUNXIAO_API_BASE_URL": "https://openapi-rdc.aliyuncs.com" // if you use region version, please replace to your instanc domain, https://your-org.devops.aliyuncs.com etc.
}
}
}
}备注: - 替换 ` 使用您的云霄访问令牌 - 这 -y` 标志自动确认安装，无需手动确认 - 此方法使用 stdio模式，通过标准输入/输出与MCP客户端通信选项2：通过MCP市场安装
灵马内置的MCP市场（阿里云同益灵马）已经提供了阿里云Devops MCP服务。要安装它，只需进入灵马的MCP市场，搜索“云霄DevOps”，然后点击安装。
______________________________________________________________________
使用Docker（可选）
运输方式
| 模式 | CLI标志 | 环境变量 | 端点 |
|---|---|---|---|
| 停止 | *（默认）* | -- | 标准输入/标准输出 |
上海证券交易所 --sse | MCP_TRANSPORT=sse | /sse + /messages | |
| 流式HTTP | --streamable-http | MCP_TRANSPORT=streamable-http | /mcp |
| 两者皆有 | --sse --streamable-http | MCP_TRANSPORT=both | /sse + /mcp |
流式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.启动服务器
音乐节目 ：
docker run -i --rm -e YUNXIAO_ACCESS_TOKEN \
build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latestSSE/流式HTTP/两者都有 --set 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可选的流式HTTP环境变量：
MCP_STREAMABLE_PATH：MCP端点路径（默认/mcp)MCP_HTTP_HOST：绑定主机（默认0.0.0.0)MCP_ALLOWED_HOSTS：允许Host标题值（逗号分隔）
3.配置MCP客户端
音乐节目 ：
{
"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": "" }
}
}
}上海证券交易所 http://localhost:3000/sse
流式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 （苏格兰和南方交易所）或 http://localhost:3000/mcp （流式HTTP）
工具集
服务器现在支持工具集，允许您仅启用所需的工具。这可以减少提供给AI助手的工具数量并提高性能。
可用工具集：
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如果未指定工具集，则默认情况下将启用所有工具。
工具
阿里巴巴云devops mcp服务器集成了各种工具，包括：
组织管理
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：通过用户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：\[项目管理\]更新sprintsearch_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: \[Project Management\] 获取用户的实际工时明细，结束时间和开始时间的间隔不能大于6个月list_effort_records: \[Project Management\] 获取实际工时明细create_effort_record: \[Project Management\] 登记实际工时list_estimated_efforts: \[Project Management\] 获取预计工时明细create_estimated_effort: \[Project Management\] 登记预计工时update_effort_record: \[Project Management\] 更新登记实际工时update_estimated_effort: \[Project Management\] 更新登记预计工时
管道管理工具
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：使用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: \[application delivery\] 创建部署单list_change_order_versions: \[application delivery\] 查看部署单版本列表get_change_order: \[application delivery\] 读取部署单使用的物料和工单状态list_change_order_job_logs: \[application delivery\] 查询环境部署单日志find_task_operation_log: \[application delivery\] 查询部署任务执行日志，其中通常包含下游部署引擎的调度细节信息execute_job_action: \[application delivery\] 操作环境部署单list_change_orders_by_origin: \[application delivery\] 根据创建来源查询部署单create_appstack_change_request: \[application delivery\] 创建变更请求get_appstack_change_request_audit_items: \[application delivery\] 获取变更请求的审批项list_appstack_change_request_executions: \[application delivery\] 列出变更请求的执行记录list_appstack_change_request_work_items: \[application delivery\] 列出变更请求的工作项cancel_appstack_change_request: \[application delivery\] 取消变更请求close_appstack_change_request: \[application delivery\] 关闭变更请求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：\[测试管理\]更新测试结果
联系我们
如果您有任何疑问，请加入阿里云Devops讨论组（134400004101）进行讨论。