云效MCP工具使用说明-云效(Alibaba Cloud DevOps)-阿里云帮助中心

云效mcp-server工具（alibabacloud-devops-mcp-server）为 AI 助手提供了与云效平台交互的能力，能够让 AI 助手可以读取项目中工作项的内容，在理解需求后自动编写代码，并提交代码合并请求。企业研发团队可以使用它协助代码审查、优化任务管理、减少重复性操作，从而专注于更重要的创新和产品交付。云效mcp-server工具是开源项目，源代码地址：https://github.com/aliyun/alibabacloud-devops-mcp-server。

功能特性

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`：通过用户ID获取组织成员信息 `search_organization_members`：搜索组织成员 `list_organization_roles`：列出组织角色 `get_organization_role`：获取组织角色信息
项目管理工具	`get_project`：获取项目详情 `search_projects`：搜索项目 `get_work_item`：获取工作项详情 `search_workitems`：搜索工作项 `get_work_item_types`：获取工作项类型 `create_work_item`：创建工作项
代码管理工具	`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_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`：更新流水线YAML内容
制品仓库工具	`list_package_repositories`：查看制品仓库信息 `list_artifacts`：查询制品信息 `get_artifact`：查看单个制品信息

安装使用

前提条件

node 版本 >= 16.0.0。
获取个人访问令牌，授予组织管理、项目协作、代码管理、流水线、制品仓库、应用交付、测试管理下所有api的读写权限。令牌的到期时间注意选择一个长期有效的时间。

安装部署方式

mcp-server主要有以下四种安装部署方式：

通过 MCP 市场安装云效 MCP 服务（推荐）

Qoder CN内置的MCP广场中已经提供了云效的MCP服务，在Qoder CN中进入MCP广场并且找到云效DevOps，单击安装。详情，请参见MCP。
将获取到的个人访问令牌填写至value中，单击立即添加。单击安装后，在弹出的安装对话框中，将环境变量 YUNXIAO_ACCESS_TOKEN 的值设置为您的云效访问令牌（Personal Access Token），然后单击立即添加。
安装完成后请在我的服务中查看，图标显示为，表示连接成功且可以正常使用。展开详情后，可以查看到 MCP 提供的工具列表。

通过 NPX 运行 MCP 服务器

将<YOUR_TOKEN>替换为获取到的个人访问令牌：

{
  "mcpServers": {
    "yunxiao": {
      "command": "npx",
      "args": [
        "-y",
        "alibabacloud-devops-mcp-server"
      ],
      "env": {
        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

通过 Docker 容器运行 MCP 服务器

从https://github.com/aliyun/alibabacloud-devops-mcp-server下载源代码。

构建镜像，在代码库根目录运行以下命令：

docker build -t alibabacloud/alibabacloud-devops-mcp-server .

配置 MCP 服务器，将<YOUR_TOKEN>替换为获取到的个人访问令牌：

{
  "mcpServers": {
    "yunxiao": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "YUNXIAO_ACCESS_TOKEN",
        "alibabacloud/alibabacloud-devops-mcp-server"
      ],
      "env": {
        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

使用mcp-server

在Qoder CN中的智能会话中选择智能体，并选择qwen3。

Project: mall-master [mall] E:\mall-master\mall-master
├── .idea
├── document
├── mall-admin
├── mall-common
├── mall-demo
├── mall-mbg
├── mall-portal
├── mall-search
├── mall-security
├── .gitignore
├── LICENSE
├── pom.xml
└── README.md
--- Lingma 通义灵码 ---
嗨，我是通义灵码，你的智能编码助手。你可以向我提编码相关的问题或提交代码让我变得更好。
如果需要了解更多的能力、动态及企业级信息，可以前往查看帮助文档。
更详细的信息来描述和更多的上下文（如文件、图片、提交等），可以让我更加理解你的诉求，并给出更好的方案和代码建议。
同时，智能体模式时，我可以使用很多工具来解决复杂的编码任务，你也可以为我添加更多贴合你工作流程的 MCP 工具。

在会话窗口中下达相应的指令进行问答或需求开发：用户发送获取组织角色信息，灵码调用 MCP 工具 yunxiao/get_current_organization_info 成功返回组织 ID（673416db230801f06d3d7ae6）、用户 ID（66a6f60e368d88cff5a513fc）及用户名 test。用户继续请求在Codeup-Demo代码库中创建一个test分支，灵码调用 yunxiao/create_branch 工具失败，返回 404 错误，提示代码库名称可能不正确或不存在于当前组织中，并给出排查建议：1. 检查拼写或大小写问题；2. 确认代码库是否存在于当前组织。

使用过程中有意见和建议，可以通过钉钉群联系我们：134400004101