云效 DevOps MCP

---

name: yunxiao-mcp description: 阿里云云效 MCP 操作工具。通过 MCP SSE 协议操作云效平台，支持项目管理、工作项管理、流水线管理、代码仓库等 165+ 工具。

---

云效 MCP Skill

阿里云云效（DevOps）MCP 操作工具，基于 MCP SSE 协议。MCP Server: http://localhost:3000

目录结构

yunxiao-mcp/
├── SKILL.md           # 本文件
├── DEPLOY.md          # MCP Server 部署与运维
└── client/            # Node.js MCP 客户端
    ├── package.json
    ├── examples/
    └── src/
        ├── client.mjs # MCP SSE 客户端核心
        ├── cli.mjs    # 命令行接口
        └── index.mjs  # 模块导出

功能概览

通过 MCP Server 提供 165+ 工具，覆盖：

项目管理: 项目查询、迭代管理、版本管理

工作项管理: 需求、任务、缺陷的查询与操作

流水线管理: 流水线创建、运行、日志查询

代码管理: 仓库、分支、文件操作

部署管理: 部署单、环境管理

快速开始

# 安装客户端
cd client && npm install
确保 MCP Server 运行（未运行参考 DEPLOY.md）
docker ps --filter "name=yunxiao-mcp"

命令速查

# 在项目 client 目录下执行以下命令
查看所有工具（Markdown 表格，省 token）
node src/cli.mjs list
查看某个工具的参数定义（JSON，含 inputSchema）
node src/cli.mjs schema get_current_user
当前用户
node src/cli.mjs call get_current_user
当前企业信息
node src/cli.mjs call get_current_organization_info
搜索项目
node src/cli.mjs call search_projects '{"organizationId": "", "perPage": 20}'
搜索需求
node src/cli.mjs call search_workitems '{"organizationId": "", "spaceId": "", "category": "Req", "perPage": 20}'
搜索 Bug
node src/cli.mjs call search_workitems '{"organizationId": "", "spaceId": "", "category": "Bug", "perPage": 20}'
获取版本列表
node src/cli.mjs call list_versions '{"organizationId": "", "id": "", "perPage": 20}'
从 stdin 传递大参数
echo '{"organizationId": ""}' | node src/cli.mjs call search_projects --stdin

典型 AI agent 调用流程

# 1. 浏览工具列表（Markdown 表格，低 token）
node src/cli.mjs list
2. 获取目标工具参数定义（JSON，按需获取）
node src/cli.mjs schema search_workitems
3. 执行调用（JSON 结果）
node src/cli.mjs call search_workitems '{"organizationId":"xxx","spaceId":"yyy","category":"Req"}'

常用工具速查

项目管理

| 工具名 | 说明 | |--------|------| | search_projects | 搜索项目列表 | | get_project | 获取项目详情 | | list_versions | 获取版本列表 | | list_sprints | 获取迭代列表 |

工作项管理

| 工具名 | 说明 | |--------|------| | search_workitems | 搜索工作项（需求/Bug/任务） | | get_work_item | 获取工作项详情 | | create_work_item | 创建工作项 | | update_work_item | 更新工作项 |

流水线管理

| 工具名 | 说明 | |--------|------| | list_pipelines | 获取流水线列表 | | get_pipeline | 获取流水线详情 | | create_pipeline_run | 运行流水线 | | get_pipeline_run | 获取运行记录 |

代码管理

| 工具名 | 说明 | |--------|------| | list_repositories | 获取代码仓库列表 | | list_branches | 获取分支列表 | | get_file_blobs | 获取文件内容 | | create_file | 创建文件 |

参数说明

必填参数

| 参数 | 说明 | |------|------| | organizationId | 企业 ID，可通过 get_current_organization_info 获取 | | spaceId | 项目 ID | | category | 工作项类型，取值见下表 |

工作项类型 (category)

| 值 | 说明 | |----|------| | Req | 需求 | | Bug | 缺陷 | | Task | 任务 | | Risk | 风险 | | Topic | 主题 | | Request | 诉求 |

Node.js API 使用

import { createClient } from './src/index.mjs';
const client = await createClient('http://localhost:3000');
const result = await client.callTool('search_workitems', {
  organizationId: '',
  spaceId: '',
  category: 'Req',
  perPage: 10,
});
console.log(JSON.stringify(result));
await client.close();

相关资源

MCP Server 部署与运维: DEPLOY.md

云效官方文档: https://help.aliyun.com/zh/yunxiao/

MCP 协议: https://modelcontextprotocol.io/