阿里云开发运维MCP服务器
项目介绍
技术文档摘要
<p align="center">English | <a href="README.zh-cn.md">中文</a><br></p>alibabacloud-devops-mcp-server
阿里云DevOps MCP Server 提供了与 Yunxiao 平台交互的能力，使AI助手能够阅读项目中的工作项内容，在理解需求后自动生成代码，并提交代码合并请求。企业开发团队可以使用它来辅助代码审查、优化任务管理、减少重复操作，从而专注于更重要的创新和产品交付。
功能
alibabacloud-devops-mcp-server 为AI助手提供了以下能力：
- 代码仓库管理：查询代码仓库及其分支，创建分支
- 文件操作：创建、更新、删除和检索代码文件内容
- 代码审查：创建和管理代码审查流程
- 项目管理：搜索项目，获取项目详情
- 流水线管理：获取流水线详情，获取流水线列表，创建流水线运行实例，获取最新流水线运行实例，获取流水线运行详情，获取流水线运行列表，查询/运行流水线部署任务
- 包管理：获取包仓库详情列表，获取制品详情列表，获取单个制品详情
- 应用交付：创建和管理部署订单、应用程序、编排、变量组、模板、标签、全局变量和部署资源
工具
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：通过用户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：获取仓库列表
项目管理工具
get_project：获取项目详情search_projects：搜索项目get_sprint：获取冲刺详情list_sprints：列出项目中的冲刺get_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_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：使用自然语言时间引用智能搜索流水线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更新Yunxiao中的现有流水线。用于更新流水线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：获取虚拟机部署机器日志
包管理工具
list_package_repositories：获取包仓库详情列表list_artifacts：获取制品详情列表get_artifact：获取单个制品详情
应用交付工具
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_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：[应用交付] 将主机列表添加到部署组
使用方法
前提条件
快速开始（推荐：使用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标志会自动确认安装，无需手动确认- 此方法使用stdio模式，通过标准输入/输出与MCP客户端通信
方案2：通过MCP市场安装
内置在Lingma（阿里巴巴云通义灵马）中的MCP市场已经提供了阿里云DevOps MCP服务。要安装它，只需进入Lingma的MCP市场，搜索“Yunxiao DevOps”，然后点击安装。
方案3：通过Smithery安装
要通过Smithery自动安装阿里巴巴云DevOps Server：
npx -y @smithery/cli install @aliyun/alibabacloud-devops-mcp-server --client claude
使用Docker（可选）
如果您需要使用Docker运行MCP服务器，可以选择stdio模式或SSE模式。
Docker与Stdio模式
此方法类似于直接使用npx，但通过Docker容器运行。
1. 获取Docker镜像
方案1：使用官方镜像（推荐）
docker pull build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:v0.2.0
方案2：构建您自己的镜像
docker build -t alibabacloud/alibabacloud-devops-mcp-server .
2. 配置MCP客户端
在您的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:v0.2.0"
],
"env": {
"YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
注意：
- 如果使用自建镜像，请将镜像名替换为
alibabacloud/alibabacloud-devops-mcp-server- 此方法使用stdio模式，容器通过标准输入/输出进行通信
Docker与SSE模式
SSE模式通过HTTP提供服务，适合需要独立服务或多用户支持的场景。
1. 启动SSE服务
使用官方镜像：
docker run -d --name yunxiao-mcp \
-p 3000:3000 \
-e YUNXIAO_ACCESS_TOKEN="your_token_here" \
-e PORT=3000 \
-e MCP_TRANSPORT=sse \
build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:v0.2.0 \
node dist/index.js --sse
使用自建镜像：
docker run -d --name yunxiao-mcp \
-p 3000:3000 \
-e YUNXIAO_ACCESS_TOKEN="your_token_here" \
-e PORT=3000 \
-e MCP_TRANSPORT=sse \
alibabacloud/alibabacloud-devops-mcp-server \
node dist/index.js --sse
2. 配置MCP客户端
在您的MCP客户端配置文件中添加以下内容：
{
"mcpServers": {
"yunxiao": {
"url": "http://localhost:3000/sse"
}
}
}
如果需要在连接时传递您自己的令牌（而不是使用服务器启动时的默认令牌）：
{
"mcpServers": {
"yunxiao": {
"url": "http://localhost:3000/sse?yunxiao_access_token=YOUR_TOKEN_HERE"
}
}
}
3. 管理SSE服务
查看日志：
docker logs -f yunxiao-mcp
停止服务：
docker stop yunxiao-mcp
通过Docker Compose运行SSE模式
- 环境设置
cd alibabacloud-devops-mcp-server
cp .env.example .env
# 编辑.env文件并设置YUNXIAO_ACCESS_TOKEN
- 启动服务
docker compose up -d
- 配置MCP客户端
{
"mcpServers": {
"yunxiao": {
"url": "http://localhost:3000/sse"
}
}
}
高级SSE模式配置
使用自定义令牌
在SSE模式下，每个用户可以通过以下方式传递他们自己的令牌：
- 通过查询参数（推荐）：
http://localhost:3000/sse?yunxiao_access_token=USER_SPECIFIC_TOKEN
- 通过请求头：
x-yunxiao-token: USER_SPECIFIC_TOKEN
这允许多个用户共享同一个SSE服务，同时使用各自的令牌进行身份验证。
在Codex中配置SSE模式
如果您的Yunxiao MCP服务器已经在SSE模式下运行于http://localhost:3000，您可以按照以下方式在Codex中进行配置：
使用默认令牌（在服务器启动时配置）：
{
"mcpServers": {
"yunxiao": {
"url": "http://localhost:3000/sse"
}
}
}
在URL中传递令牌：
{
"mcpServers": {
"yunxiao": {
"url": "http://localhost:3000/sse?yunxiao_access_token=YOUR_TOKEN_HERE"
}
}
}
工具集
服务器现在支持工具集，允许您仅启用所需的工具。这可以减少呈现给AI助手的工具数量，提高性能。
可用工具集：
base：始终加载的基础工具（get_current_user, get_current_organization_info, get_user_organizations）- `code