English | 中文

alibabacloud-devops-mcp-server

AlibabaCloud Devops MCP Server provides AI assistants with the ability to interact with the Yunxiao platform, enabling them to read work item contents in projects, automatically write code after understanding requirements, and submit code merge requests. Enterprise development teams can use it to assist with code reviews, optimize task management, reduce repetitive operations, and thus focus on more important innovation and product delivery.

Features

alibabacloud-devops-mcp-server provides the following capabilities for AI assistants:

• organization-management: Organization management tools (organization list, organization details, department information, organizational roles, member information, etc.)
• code-management: Code repository management tools (repository management, branch management, merge request management, file tree, etc.)
• project-management: Project management tools (project management, work item management, work item fields, work item comments, time tracking, etc.)
• pipeline-management: Pipeline management tools (pipeline list, pipeline configuration, resource management, tag management, deployment management, etc.)
• application-delivery: Application delivery tools (deployment order management, application management, application tags, variable group management, etc.)
• packages-management: Artifact repository management tools (artifact repositories, artifact lists, etc.)
• test-management: Test management tools (test case management, test case directories, test plans, test results, etc.)

Usage

Region Edition Support

This tool supports both Yunxiao central station and Region edition deployment modes:

• Central Station: Uses https://openapi-rdc.aliyuncs.com as the API domain
• Region Edition: Uses organization-specific domains, such as https://your-org.devops.aliyuncs.com

Automatic Mode Detection

The tool automatically determines the deployment mode based on the configured API base URL:

• If the URL contains openapi-rdc.aliyuncs.com, it operates in central station mode
• Otherwise, it operates in region edition mode

Configuring Region Edition

When using a Region edition, set the YUNXIAO_API_BASE_URL environment variable:

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

organizationId Parameter in Region Mode

In Region mode, the organizationId parameter becomes optional:

• Central Station Mode: organizationId is required and must be explicitly provided by the user
• Region Mode: organizationId can be omitted, and the system will automatically use the default value "default"

This means in Region mode, users don't need to worry about organization IDs - the tool handles it automatically.

Prerequisites

• node version >= 18.0.0

• AlibabaCloud Devops Personal Access Token, click here to obtain. Grant read and write permissions to all APIs under organization management, project collaboration, code management, pipeline management, artifact repository management, application delivery and testing management.

  

Quick Start (Recommended: Using Stdio Mode)

Stdio mode is the simplest and most common way, suitable for most MCP clients (like Cursor, Claude Desktop, iFlow, etc.). No Docker installation required, just run via npx.

Option 1: Direct Use via NPX (Simplest)

Add the fo

... View full README on GitHub