AlibabaCloud DevOps MCP

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 執行。

選項 1：透過 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：測試管理工具（測試案例管理、測試案例目錄、測試計劃、測試結果等）

要使用工具集，您可以透過命令列參數或環境變數來指定：

1. 透過命令列參數：

npx -y alibabacloud-devops-mcp-server --toolsets=code-management,project-management

2. 透過環境變數：

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：建立合併請求
• 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：列出可與特定工作項關聯的工作項類型
• 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：[專案管理] 獲取使用者的實際工時明細，結束時間和開始時間的間隔不能大於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：停止虛擬機器部署單
• skip_vm_deploy_machine：略過虛擬機器部署機器
• retry_vm_deploy_machine：重試虛擬機器部署機器
• resume_vm_deploy_order：恢復虛擬機器部署單
• get_vm_deploy_order：取得虛擬機器部署單詳細資訊
• get_vm_deploy_machine_log：取得虛擬機器部署機器日誌

應用交付工具

• 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：[測試管理] 更新測試結果

聯絡我們

如果您有任何疑問，請加入阿里雲 DevOps 討論群組 (134400004101) 進行討論。

相關連結

• 阿里雲 DevOps
• MCP 市場
• 範例使用案例
• 使用雲效進行專案管理
• 使用雲效進行程式碼管理