云效 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": "<org_id>", "perPage": 20}'

# 搜索需求
node src/cli.mjs call search_workitems '{"organizationId": "<org_id>", "spaceId": "<project_id>", "category": "Req", "perPage": 20}'

# 搜索 Bug
node src/cli.mjs call search_workitems '{"organizationId": "<org_id>", "spaceId": "<project_id>", "category": "Bug", "perPage": 20}'

# 获取版本列表
node src/cli.mjs call list_versions '{"organizationId": "<org_id>", "id": "<project_id>", "perPage": 20}'

# 从 stdin 传递大参数
echo '{"organizationId": "<org_id>"}' | 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"}'

常用工具速查

项目管理

工作项管理

流水线管理

代码管理

参数说明

必填参数

工作项类型 (category)

Node.js API 使用

import { createClient } from './src/index.mjs';

const client = await createClient('http://localhost:3000');
const result = await client.callTool('search_workitems', {
  organizationId: '<org_id>',
  spaceId: '<project_id>',
  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/