alibabacloud-devops-mcp-server

阿里云云效 MCP Server（alibabacloud-devops-mcp-server）是阿里云提供的开源 DevOps 工具，为 AI 助手提供与云效平台交互的能力。它封装了一组调用云效 API 的工具，使 AI 助手可以读取项目中的工作项内容、在理解需求后自动编写代码并提交代码合并请求。企业研发团队可用于辅助代码评审、优化任务管理、减少重复操作，从而更专注于创新和产品交付。

【主要能力】 该服务提供以下工具集（toolset），每个工具集覆盖不同领域：

• organization-management：组织管理工具，包括组织列表、组织详情、部门信息、组织角色、成员信息等。
• code-management：代码仓库管理工具，包括仓库管理、分支管理、合并请求管理、文件树等，具体工具有 create_branch、delete_branch、get_branch、list_branches、create_file、delete_file、get_file_blobs、list_files、update_file、create_change_request、update_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 等。
• project-management：项目管理工具，包括项目、工作项、工作项字段、工作项评论、工时追踪等，具体工具有 get_project、search_projects、get_sprint、list_sprints、create_sprint、update_sprint、search_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、list_workitem_relation_records、create_workitem_relation_record、delete_workitem_relation_record、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、list_effort_records、create_effort_record、list_estimated_efforts、create_estimated_effort、update_effort_record、update_estimated_effort）等。
• pipeline-management：流水线管理工具，包括流水线列表、流水线配置、资源管理、标签管理、部署管理等，具体工具有 get_pipeline、list_pipelines、smart_list_pipelines、generate_pipeline_yaml、create_pipeline_from_description、update_pipeline、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_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，以及 VM 部署相关工具（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）等。
• application-delivery：应用交付工具，包括部署单管理、应用管理、应用标签、变量组管理等，具体工具有 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，以及变更请求相关工具（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），和应用编排相关工具（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）等。
• packages-management：制品仓库管理工具（制品仓库、制品列表等）。
• test-management：测试管理工具（测试用例管理、测试用例目录、测试计划、测试结果等）。

【使用方式】

1. 版本支持：支持云效中心站和 Region 版两种部署模式。中心站使用 https://openapi-rdc.aliyuncs.com 作为 API 域名；Region 版使用组织专属域名，如 https://your-org.devops.aliyuncs.com。工具根据配置的 API base URL 自动判断部署模式：若 URL 包含 openapi-rdc.aliyuncs.com 则为中心站模式，否则为 Region 版模式。使用 Region 版时需设置环境变量 YUNXIAO_API_BASE_URL。
2. 前置条件：Node 版本 ≥ 18.0.0；需要阿里云云效个人访问令牌（Personal Access Token），并授予组织管理、项目协作、代码管理、流水线管理、制品仓库管理、应用交付和测试管理下所有 API 的读写权限。
3. 官方托管 MCP 服务（无需安装）：云效提供官方托管的 MCP 端点，无需本地安装或 Docker。中心站端点：https://openapi-rdc.aliyuncs.com/ai/mcp；Region 版端点：组织 Region 域名 + /ai/mcp，例如 https://<your-org>.devops.aliyuncs.com/ai/mcp。传输方式为 Streamable HTTP（无状态）；认证使用 Authorization: Bearer <YOUR_TOKEN> 或请求头 X-Yunxiao-Token: <YOUR_TOKEN>。可通过 ?toolsets=code-management,project-management 或请求头 X-Devops-Toolsets 仅请求所需的工具集以减少上下文占用。
4. 自托管 Stdio 模式（最简单）：适合大多数 MCP 客户端（如 Cursor、Claude Desktop、iFlow 等），无需 Docker，通过 npx 运行。在 MCP 客户端配置文件中添加配置，将 <YOUR_TOKEN> 替换为云效访问令牌，-y 标志自动确认安装。默认调用云效中心站 OpenAPI（https://openapi-rdc.aliyuncs.com）；若为 Region 版，需额外设置环境变量 YUNXIAO_API_BASE_URL。
5. Docker（可选）：可自行构建镜像 docker build -t alibabacloud/alibabacloud-devops-mcp-server .，启动时通过 MCP_TRANSPORT 和 PORT 设置传输模式。可选 Streamable HTTP 环境变量包括 MCP_STREAMABLE_PATH（默认 /mcp）、MCP_HTTP_HOST（默认 0.0.0.0）、MCP_ALLOWED_HOSTS（逗号分隔）。
6. 传输模式：Streamable HTTP 是 MCP 规范推荐的远程传输方式，SSE 为传统方式，迁移期间可同时使用。客户端 URL：SSE 为 http://localhost:3000/sse，Streamable HTTP 为 http://localhost:3000/mcp。
7. 工具集选择：服务支持工具集，可仅启用所需工具以减少呈现给 AI 助手的工具数量并提升性能。可通过命令行参数或环境变量指定工具集；若未指定，默认启用所有工具。

【适用场景】 面向企业研发团队，用于辅助 AI 助手在云效平台上进行代码评审、任务管理优化、减少重复操作等。具体可读取项目工作项内容、理解需求后自动编写代码并提交合并请求，也可管理代码仓库、项目、流水线、制品仓库、应用交付和测试等。

【限制】 需要 Node 版本 ≥ 18.0.0；需要云效个人访问令牌并授予相应读写权限；使用 Region 版需额外配置环境变量或域名。其余关于收费、价格等信息暂未提供。