AlibabaCloud Devops MCP Server

How to use

You connect an MCP client to the server to enable AI-assisted workflows. The server supports stdio mode for local, direct communication and can also be run in Docker with SSE for HTTP-based access. Your client can then request organization, code, project, pipeline, application delivery, packages, and test management actions via the MCP endpoints exposed by the server.

How to install

Prerequisites you need to meet before running the server or integrating with an MCP client are: Node.js version 18 or newer and an active Yunxiao access token with read and write permissions for the APIs you plan to use.

Option A: Quick start with NPX (stdio mode) in your MCP client configuration:

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

Option B: Run via Docker in stdio mode using a prebuilt image or your own build.

{
  "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:v0.2.0"
      ],
      "env": {
        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Additional installation notes

If you prefer running SSE over HTTP, you can configure a service that exposes a URL like http://localhost:3000/sse and connect your MCP client to that endpoint. The tokens can be supplied via the query string or request header to support multiple users.

Configuration and environment

The server supports toolsets that let you enable only the tools you need for better performance. By default, all tool groups are enabled if you do not specify toolsets.

Explicit toolsets available include organization-management, code-management, project-management, pipeline-management, packages-management, application-delivery, and test-management. Use these to tailor the MCP capabilities exposed to the AI assistant.

If you run in SSE mode, you can pass your own token in the URL or via the x-yunxiao-token header to authenticate individual users.

Troubleshooting and notes

View logs to diagnose issues when running in Docker SSE or stdio mode. If you stop the service, ensure you properly terminate the container or process to free resources.

Security considerations

Protect your Yunxiao access token. Do not expose it in client configurations or logs. Use environment isolation for tokens per deployment and rotate tokens periodically.

get_current_organization_Info

Retrieve the current user's organization information.

get_user_organizations

Fetch the list of organizations the current user has joined.

get_organization_role

Obtain information about an organization role.

get_organization_departments

List departments within an organization.

get_organization_department_info

Get details about a specific department.

get_organization_members

List members in an organization.

get_project

Get details for a project.

search_projects

Search for projects.

get_work_item

Get details of a work item.

create_work_item

Create a new work item.

list_all_work_item_types

List all work item types in an organization.

create_branch

Create a new repository branch.

list_repositories

List repositories in a code base.

create_change_request

Create a merge request.

get_change_request

Query a merge request.

list_change_request

Query merge request list.

list_pipeline_runs

List pipeline runs.

get_pipeline

Get pipeline details.

list_pipelines

Get pipeline list.

create_change_order

Create a deployment change order.

list_change_order_versions

View deployment order versions.