aliyun/alibabacloud-devops-mcp-server

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:
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:// .devops.aliyuncs.com/ai/mcp — the same domain you use to access Yunxiao in your region.
- Transport: Streamable HTTP (stateless)
- Auth: Authorization: Bearer (or header X-Yunxiao-Token: )
Client config — **Central** (clients with native remote support, e.g. Cursor):
Client config — **Region edition** (replace the URL with your own region domain):
> 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.
---
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:
> **Note**:
> - Replace 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