AlibabaCloud DevOps MCP

官方

Yunxiao MCP Server 提供 AI 助手與雲效平台互動的能力。

GitHub

180

你可以用 AlibabaCloud DevOps MCP 做什麼？

管理程式碼儲存庫 — 請您的助理透過 code-management 列出儲存庫、建立分支、檢視檔案樹，以及提交合併請求。
追蹤專案工作項目 — 讓您的助理使用 project-management 搜尋工作項目、更新其狀態、新增評論，並記錄工時。
執行與檢查管線 — 指示您的助理透過 pipeline-management 列出管線、觸發執行，並取得工作紀錄。
處理測試案例與計畫 — 請您的助理使用 test-management 建立測試案例、搜尋測試案例，並更新測試結果。
部署應用程式 — 引導您的助理透過 application-delivery 建立部署訂單、管理變數群組，並監控發佈工作流程。

文件

English | 中文

alibabacloud-devops-mcp-server

AlibabaCloud Devops MCP Server 為 AI 助手提供與雲效平台互動的能力，使其能夠讀取專案中的工作項內容、理解需求後自動編寫程式碼，並提交程式碼合併請求。企業開發團隊可以使用它來協助程式碼審查、優化任務管理、減少重複操作，從而專注於更重要的創新與產品交付。

功能特色

alibabacloud-devops-mcp-server 為 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": "<YOUR_TOKEN>",
        "YUNXIAO_API_BASE_URL": "https://your-org.devops.aliyuncs.com"
      }
    }
  }
}

前置需求

node 版本 >= 18.0.0
AlibabaCloud Devops 個人存取權杖，點此取得。請授予組織管理、專案協作、程式碼管理、流水線管理、製品倉庫管理、應用交付與測試管理下所有 API 的讀寫權限。

官方託管 MCP 服務（免安裝）

雲效提供官方託管的 MCP 端點 — 無需本機安裝或 Docker。只需將您的用戶端指向該端點，並使用您的雲效權杖進行驗證即可。

中心站：https://openapi-rdc.aliyuncs.com/ai/mcp
區域版：您組織的區域網域 + /ai/mcp，例如 https://<your-org>.devops.aliyuncs.com/ai/mcp — 與您在該區域存取雲效時使用的網域相同。
傳輸方式：Streamable HTTP（無狀態）
驗證：Authorization: Bearer <YOUR_TOKEN>（或標頭 X-Yunxiao-Token: <YOUR_TOKEN>）

用戶端配置 — 中心站（支援原生遠端功能的用戶端，例如 Cursor）：

{
  "mcpServers": {
    "yunxiao": {
      "url": "https://openapi-rdc.aliyuncs.com/ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

用戶端配置 — 區域版（將 URL 替換為您自己的區域網域）：

{
  "mcpServers": {
    "yunxiao": {
      "url": "https://<your-org>.devops.aliyuncs.com/ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

提示：僅請求您需要的工具集以減少上下文使用量 — ?toolsets=code-management,project-management 或標頭 X-Devops-Toolsets。請參閱完整指南：docs/hosted-mcp-guide.zh-CN.md。

快速開始（自架，使用 Stdio 模式）

Stdio 模式是最簡單的自架方式，適用於大多數 MCP 用戶端（如 Cursor、Claude Desktop、iFlow 等）。無需安裝 Docker，直接透過 npx 執行即可。

選項一：透過 NPX 直接使用（最簡單）

在您的 MCP 用戶端配置檔案中新增以下配置：

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

注意：

將 <YOUR_TOKEN> 替換為您的雲效存取權杖

-y 旗標會自動確認安裝，無需手動確認

預設情況下，工具會呼叫雲效中心站 OpenAPI（https://openapi-rdc.aliyuncs.com）；無需額外配置

如果您使用的是區域版（組織專屬網域），請設定額外的環境變數 YUNXIAO_API_BASE_URL 為您的雲效實例 URL，例如 https://your-org.devops.aliyuncs.com。詳情請參閱上方設定區域版一節

此方法使用 stdio 模式，透過標準輸入/輸出與 MCP 用戶端通訊

使用 Docker（選用）

傳輸模式

模式	CLI 旗標	環境變數	端點
Stdio	（預設）	—	stdin/stdout
SSE	`--sse`	`MCP_TRANSPORT=sse`	`/sse` + `/messages`
Streamable HTTP	`--streamable-http`	`MCP_TRANSPORT=streamable-http`	`/mcp`
兩者	`--sse --streamable-http`	`MCP_TRANSPORT=both`	`/sse` + `/mcp`

Streamable 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. 啟動伺服器

Stdio：

docker run -i --rm -e YUNXIAO_ACCESS_TOKEN \
  build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest

SSE / Streamable HTTP / 兩者 — 設定 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

選用的 Streamable HTTP 環境變數：

MCP_STREAMABLE_PATH：MCP 端點路徑（預設 /mcp）
MCP_HTTP_HOST：綁定主機（預設 0.0.0.0）
MCP_ALLOWED_HOSTS：允許的 Host 標頭值（以逗號分隔）

3. 配置 MCP 用戶端

Stdio：

{
  "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": "<YOUR_TOKEN>" }
    }
  }
}

SSE： http://localhost:3000/sse

Streamable 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（SSE）或 http://localhost:3000/mcp（Streamable 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

若未指定工具集，預設將啟用所有工具。

工具

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：建立合併請求
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：[程式碼管理] 在提交上建立評論

專案管理工具

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：為特定工作項建立評論；可選的 formatType：RICHTEXT（預設）或 MARKDOWN
list_workitem_attachments：列出特定工作項的附件
get_workitem_file：取得特定工作項附件的檔案資訊
create_workitem_attachment：上傳本機檔案作為工作項的附件
list_workitem_activities：列出工作項的活動歷史（欄位變更、狀態轉換、關聯變更）
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：使用自然語言時間參照進行智慧管線搜尋
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：[應用交付] 建立部署單
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：[應用交付] 更新應用程式編排
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：[測試管理] 更新測試結果

聯絡我們

如果您有任何問題，請加入釘釘群組「雲效mcp server&智能化用戶溝通2群」（ID：177120034028）。

Alibaba Cloud DevOps MCP Server DingTalk Group