阿里云MCP服务器

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.

Official Hosted MCP Service (No Install)

Yunxiao provides an officially hosted MCP endpoint — no local install or Docker needed. Just point your client at it and authenticate with your Yunxiao token.

• Central: https://openapi-rdc.aliyuncs.com/ai/mcp
• Region edition: your organization's region domain + /ai/mcp, e.g. https://<your-org>.devops.aliyuncs.com/ai/mcp — the same domain you use to access Yunxiao in your region.
• Transport: Streamable HTTP (stateless)
• Auth: Authorization: Bearer <YOUR_TOKEN> (or header X-Yunxiao-Token: <YOUR_TOKEN>)

Client config — Central (clients with native remote support, e.g. Cursor):

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

Client config — Region edition (replace the URL with your own region domain):

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

Tip: cut context usage by requesting only the toolsets you need — ?toolsets=code-management,project-management or header X-Devops-Toolsets. See the full guide: docs/hosted-mcp-guide.zh-CN.md.

---

Using Docker (Optional)

Docker Compose

cp .env.example .env   # set YUNXIAO_ACCESS_TOKEN
docker compose up -d

Client URL: http://localhost:3000/sse (SSE) or http://localhost:3000/mcp (Streamable HTTP)

Usage

Quick Start (Self-host, Using Stdio Mode)

Stdio mode is the simplest self-hosting 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 following configuration to your MCP client configuration file:

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

Note: - Replace <YOUR_TOKEN> with your Yunxiao access token - The -y flag automatically confirms installation without manual confirmation - By default the tool calls the Yunxiao Central Station OpenAPI (https://openapi-rdc.aliyuncs.com); no extra configuration is required - If you are on a Region edition (organization-specific domain), set an additional environment variable YUNXIAO_API_BASE_URL to your Yunxiao instance URL, e.g. https://your-org.devops.aliyuncs.com. See the Configuring Region Edition section above for details - This method uses stdio mode, communicating with the MCP client via standard input/output

---

3. Configure MCP Client

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

Pass credentials via query parameter or header:

http://localhost:3000/mcp?yunxiao_access_token=YOUR_TOKEN_HERE

Region / instance OpenAPI base:

http://localhost:3000/mcp?yunxiao_access_token=TOKEN&yunxiao_api_base_url=https%3A%2F%2Fyour-org.devops.aliyuncs.com

Pipeline Management Tools

• get_pipeline: Get pipeline details
• list_pipelines: Get pipeline list
• smart_list_pipelines: Smart pipeline search with natural language time references
• generate_pipeline_yaml: [Pipeline Management] Generate pipeline YAML configuration
• create_pipeline_from_description: Create a pipeline from natural language description
• update_pipeline: [Pipeline Management] Update pipeline YAML content
• create_pipeline_run: Create a pipeline run instance
• get_latest_pipeline_run: Get the latest pipeline run instance
• get_pipeline_run: Get pipeline run details
• list_pipeline_runs: Get pipeline run list
• list_pipeline_jobs_by_category: Get pipeline execution tasks by category
• list_pipeline_job_historys: Get the execution history of a pipeline task
• execute_pipeline_job_run: Manually run a pipeline task
• get_pipeline_job_run_log: Get the execution logs of a pipeline job
• list_service_connections: List service connections in organization
• create_pipeline_from_description: Automatically generates YAML configuration and creates pipeline
• update_pipeline: Update an existing pipeline in Yunxiao by pipelineId. Use this to update pipeline YAML, stages, jobs, etc.
• create_resource_member: Create a resource member
• delete_resource_member: Delete a resource member
• list_resource_members: Get a list of resource members
• update_resource_member: Update a resource member
• update_resource_owner: Transfer resource owner
• create_tag: Create a tag
• create_tag_group: Create a tag group
• list_tag_groups: Get a list of tag groups
• delete_tag_group: Delete a tag group
• update_tag_group: Update a tag group
• get_tag_group: Get a tag group
• delete_tag: Delete a tag
• update_tag: Update a tag
• stop_vm_deploy_order: Stop VM deploy order
• skip_vm_deploy_machine: Skip VM deploy machine
• retry_vm_deploy_machine: Retry VM deploy machine
• resume_vm_deploy_order: Resume VM deploy order
• get_vm_deploy_order: Get VM deploy order details
• get_vm_deploy_machine_log: Get VM deploy machine log

Packages Management Tools

• list_package_repositories: Get package repositories details list
• list_artifacts: Get artifacts details list
• get_artifact: Get single artifact details