AlibabaCloud DevOps MCP

公式

Yunxiao MCP Serverは、AIアシスタントがYunxiaoプラットフォームと対話する機能を提供します。

GitHub

180

AlibabaCloud DevOps MCPで何ができますか？

コードリポジトリの管理 — アシスタントにリポジトリの一覧表示、ブランチの作成、ファイルツリーの表示、マージリクエストの提出をcode-management経由で依頼します。
プロジェクト作業項目の追跡 — アシスタントに作業項目の検索、ステータスの更新、コメントの追加、時間の記録をproject-managementを使用して依頼します。
パイプラインの実行と検査 — アシスタントにパイプラインの一覧表示、実行のトリガー、ジョブログの取得をpipeline-managementを通じて指示します。
テストケースとテスト計画の処理 — アシスタントにテストケースの作成、検索、テスト結果の更新をtest-managementで依頼します。
アプリケーションのデプロイ — アシスタントにデプロイメントオーダーの作成、変数グループの管理、リリースワークフローの監視をapplication-delivery経由で指示します。

ドキュメント

English | 中文

alibabacloud-devops-mcp-server

AlibabaCloud Devops MCP Server は、AIアシスタントにYunxiaoプラットフォームと対話する機能を提供し、プロジェクト内のワークアイテムの内容を読み取り、要件を理解した後に自動でコードを記述し、コードマージリクエストを送信することを可能にします。エンタープライズ開発チームは、これをコードレビューの支援、タスク管理の最適化、反復作業の削減に活用し、より重要なイノベーションと製品デリバリーに集中できます。

機能

alibabacloud-devops-mcp-server は、AIアシスタントに以下の機能を提供します：

organization-management: 組織管理ツール（組織一覧、組織詳細、部門情報、組織ロール、メンバー情報など）
code-management: コードリポジトリ管理ツール（リポジトリ管理、ブランチ管理、マージリクエスト管理、ファイルツリーなど）
project-management: プロジェクト管理ツール（プロジェクト管理、ワークアイテム管理、ワークアイテムフィールド、ワークアイテムコメント、時間追跡など）
pipeline-management: パイプライン管理ツール（パイプライン一覧、パイプライン設定、リソース管理、タグ管理、デプロイ管理など）
application-delivery: アプリケーションデリバリーツール（デプロイメントオーダー管理、アプリケーション管理、アプリケーションタグ、変数グループ管理など）
packages-management: アーティファクトリポジトリ管理ツール（アーティファクトリポジトリ、アーティファクト一覧など）
test-management: テスト管理ツール（テストケース管理、テストケースディレクトリ、テスト計画、テスト結果など）

使用方法

リージョン版のサポート

このツールは、Yunxiaoセントラルステーションとリージョン版の両方のデプロイモードをサポートしています：

セントラルステーション: APIドメインとして https://openapi-rdc.aliyuncs.com を使用
リージョン版: 組織固有のドメインを使用（例：https://your-org.devops.aliyuncs.com）

自動モード検出

ツールは、設定されたAPIベースURLに基づいてデプロイモードを自動的に決定します：

URLに openapi-rdc.aliyuncs.com が含まれる場合、セントラルステーションモードで動作
それ以外の場合は、リージョン版モードで動作

リージョン版の設定

リージョン版を使用する場合、YUNXIAO_API_BASE_URL 環境変数を設定します：

{
  "mcpServers": {
    "yunxiao": {
      "command": "npx",
      "args": ["-y", "alibabacloud-devops-mcp-server"],
      "env": {
        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "YUNXIAO_API_BASE_URL": "https://your-org.devops.aliyuncs.com"
      }
    }
  }
}

前提条件

node バージョン >= 18.0.0
AlibabaCloud Devops 個人アクセストークン。こちらから取得。組織管理、プロジェクトコラボレーション、コード管理、パイプライン管理、アーティファクトリポジトリ管理、アプリケーションデリバリー、テスト管理のすべてのAPIに対する読み取り・書き込み権限を付与してください。

公式ホスト型MCPサービス（インストール不要）

Yunxiaoは公式ホスト型のMCPエンドポイントを提供しています。ローカルインストールやDockerは不要です。クライアントをそのエンドポイントに接続し、Yunxiaoトークンで認証するだけです。

セントラル: https://openapi-rdc.aliyuncs.com/ai/mcp
リージョン版: 組織のリージョンドメイン + /ai/mcp（例：https://<your-org>.devops.aliyuncs.com/ai/mcp）— リージョンでYunxiaoにアクセスする際と同じドメインです。
トランスポート: Streamable HTTP（ステートレス）
認証: Authorization: Bearer <YOUR_TOKEN>（またはヘッダー X-Yunxiao-Token: <YOUR_TOKEN>）

クライアント設定 — セントラル（Cursorなど、ネイティブのリモートサポートを持つクライアント向け）：

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

クライアント設定 — リージョン版（URLを自分のリージョンドメインに置き換えてください）：

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

ヒント：必要なツールセットのみをリクエストすることでコンテキスト使用量を削減できます — ?toolsets=code-management,project-management またはヘッダー X-Devops-Toolsets。完全なガイドはこちら：docs/hosted-mcp-guide.zh-CN.md。

クイックスタート（セルフホスト、Stdioモード使用）

Stdioモードは最もシンプルなセルフホスト方法で、ほとんどのMCPクライアント（Cursor、Claude Desktop、iFlowなど）に適しています。Dockerのインストールは不要で、npxで実行するだけです。

オプション1：NPXによる直接使用（最も簡単）

MCPクライアントの設定ファイルに以下の設定を追加します：

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

注意：

<YOUR_TOKEN> を自分のYunxiaoアクセストークンに置き換えてください

-y フラグは、手動確認なしでインストールを自動的に確認します

デフォルトでは、ツールはYunxiaoセントラルステーションOpenAPI（https://openapi-rdc.aliyuncs.com）を呼び出します。追加設定は不要です

リージョン版（組織固有のドメイン）を使用している場合は、追加の環境変数 YUNXIAO_API_BASE_URL をYunxiaoインスタンスのURLに設定してください（例：https://your-org.devops.aliyuncs.com）。詳細は上記のリージョン版の設定セクションを参照してください

この方法はstdioモードを使用し、標準入出力を介してMCPクライアントと通信します

Dockerの使用（オプション）

トランスポートモード

モード	CLIフラグ	環境変数	エンドポイント
Stdio	(デフォルト)	—	stdin/stdout
SSE	`--sse`	`MCP_TRANSPORT=sse`	`/sse` + `/messages`
Streamable HTTP	`--streamable-http`	`MCP_TRANSPORT=streamable-http`	`/mcp`
両方	`--sse --streamable-http`	`MCP_TRANSPORT=both`	`/sse` + `/mcp`

Streamable HTTPはMCP仕様で推奨されるリモートトランスポートです。SSEはレガシーです。移行中は both を使用してください。

1. イメージのプル

docker pull build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest

セルフビルド：docker build -t alibabacloud/alibabacloud-devops-mcp-server .

2. サーバーの起動

Stdio:

docker run -i --rm -e YUNXIAO_ACCESS_TOKEN \
  build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest

SSE / Streamable HTTP / 両方 — MCP_TRANSPORT を設定し、PORT を公開します：

docker run -d --name yunxiao-mcp -p 3000:3000 \
  -e YUNXIAO_ACCESS_TOKEN="your_token" -e PORT=3000 \
  -e MCP_TRANSPORT=streamable-http \   # sse | streamable-http | both
  build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest

オプションのStreamable HTTP環境変数：

MCP_STREAMABLE_PATH: MCPエンドポイントパス（デフォルト /mcp）
MCP_HTTP_HOST: バインドホスト（デフォルト 0.0.0.0）
MCP_ALLOWED_HOSTS: 許可される Host ヘッダー値（カンマ区切り）

3. MCPクライアントの設定

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

クエリパラメータまたはヘッダーで資格情報を渡します：

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

またはリクエストヘッダー：x-yunxiao-token: YOUR_TOKEN_HERE

リージョン / インスタンスOpenAPIベース：

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

またはリクエストヘッダー：x-yunxiao-api-base-url: https://your-org.devops.aliyuncs.com

Docker Compose

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

クライアントURL：http://localhost:3000/sse（SSE）または http://localhost:3000/mcp（Streamable HTTP）

ツールセット

サーバーはツールセットをサポートしており、必要なツールのみを有効にできます。これにより、AIアシスタントに提示されるツールの数を減らし、パフォーマンスを向上させることができます。

利用可能なツールセット：

organization-management: 組織管理ツール（組織一覧、組織詳細、部門情報、組織ロール、メンバー情報など）
code-management: コードリポジトリ管理ツール（リポジトリ管理、ブランチ管理、マージリクエスト管理、ファイルツリーなど）
project-management: プロジェクト管理ツール（プロジェクト管理、ワークアイテム管理、ワークアイテムフィールド、ワークアイテムコメント、時間追跡など）
pipeline-management: パイプライン管理ツール（パイプライン一覧、パイプライン設定、リソース管理、タグ管理、デプロイ管理など）
packages-management: アーティファクトリポジトリ管理ツール（アーティファクトリポジトリ、アーティファクト一覧など）
application-delivery: アプリケーションデリバリーツール（デプロイメントオーダー管理、アプリケーション管理、アプリケーションタグ、変数グループ管理など）
test-management: テスト管理ツール（テストケース管理、テストケースディレクトリ、テスト計画、テスト結果など）

ツールセットを使用するには、コマンドライン引数または環境変数で指定できます：

コマンドライン引数で指定：

npx -y alibabacloud-devops-mcp-server --toolsets=code-management,project-management

環境変数で指定：

DEVOPS_TOOLSETS=code-management,project-management npx -y alibabacloud-devops-mcp-server

ツールセットが指定されていない場合、デフォルトですべてのツールが有効になります。

ツール

alibabacloud-devops-mcp-server は、以下のさまざまなツールを統合しています：

組織管理

get_current_organization_Info: 現在のユーザーの組織情報を取得
get_user_organizations: 現在のユーザーが参加している組織の一覧を取得
get_organization_role: 組織ロールの情報を取得
get_organization_departments: 組織内の部門一覧を取得
get_organization_department_info: 組織内の部門情報を取得
get_organization_department_ancestors: 組織内の部門の祖先を取得
get_organization_members: 組織内のメンバー一覧を取得
get_organization_member_info: 組織内のメンバー情報を取得
get_organization_member_info_by_user_id: ユーザーIDで組織内のメンバー情報を取得
search_organization_members: 組織メンバーを検索
list_organization_roles: 組織ロールを一覧表示
get_organization_role: 組織ロールの情報を取得

コード管理ツール

create_branch: ブランチを作成
delete_branch: ブランチを削除
get_branch: ブランチ情報を取得
list_branches: ブランチ一覧を取得
create_file: ファイルを作成
delete_file: ファイルを削除
get_file_blobs: ファイル内容を取得
list_files: ファイルツリーを照会
update_file: ファイル内容を更新
create_change_request: マージリクエストを作成
update_change_request: マージリクエストのタイトルまたは説明を更新
create_change_request_comment: マージリクエストにコメントを作成
get_change_request: マージリクエストを照会
list_change_request_patch_sets: マージリクエストのバージョン一覧を照会
list_change_request: マージリクエスト一覧を照会
list_change_request_comments: マージリクエストのコメント一覧を照会
get_compare: コードを比較
get_repository: リポジトリ詳細を取得
list_repositories: リポジトリ一覧を取得
list_commits: [コード管理] リポジトリ内のコミット一覧を取得
get_commit: [コード管理] コミット詳細を取得
create_commit_comment: [コード管理] コミットにコメントを作成

プロジェクト管理ツール

get_project: プロジェクト詳細を取得
search_projects: プロジェクトを検索
get_sprint: スプリント詳細を取得
list_sprints: プロジェクト内のスプリント一覧を取得
create_sprint: [プロジェクト管理] スプリントを作成
update_sprint: [プロジェクト管理] スプリントを更新
search_programs: [プロジェクト管理] プログラムを検索
list_program_versions: [プロジェクト管理] プログラムバージョンを一覧表示
list_versions: [プロジェクト管理] プロジェクトバージョンを一覧表示
create_version: [プロジェクト管理] バージョンを作成
update_version: [プロジェクト管理] バージョンを更新
delete_version: [プロジェクト管理] バージョンを削除
get_work_item: ワークアイテム詳細を取得
update_work_item: [プロジェクト管理] ワークアイテムを更新
search_workitems: ワークアイテムを検索
get_work_item_types: ワークアイテムタイプを取得
create_work_item: ワークアイテムを作成
list_all_work_item_types: 組織内のすべてのワークアイテムタイプを一覧表示
list_work_item_types: プロジェクトスペース内のワークアイテムタイプを一覧表示
get_work_item_type: 特定のワークアイテムタイプの詳細を取得
list_work_item_relation_work_item_types: 特定のワークアイテムに関連付けることができるワークアイテムタイプを一覧表示
list_workitem_relation_records: ワークアイテムの関連レコードを一覧表示
create_workitem_relation_record: ワークアイテムを別のワークアイテムに関連付ける
delete_workitem_relation_record: ワークアイテムの関連を削除
get_work_item_type_field_config: 特定のワークアイテムタイプのフィールド設定を取得
get_work_item_workflow: 特定のワークアイテムタイプのワークフロー情報を取得
list_work_item_comments: 特定のワークアイテムのコメント一覧を取得
create_work_item_comment: 特定のワークアイテムにコメントを作成。オプションの formatType: RICHTEXT（デフォルト）または MARKDOWN
list_workitem_attachments: 特定のワークアイテムの添付ファイル一覧を取得
get_workitem_file: 特定のワークアイテム添付ファイルのファイル情報を取得
create_workitem_attachment: ローカルファイルをワークアイテムの添付ファイルとしてアップロード
list_workitem_activities: ワークアイテムのアクティビティ履歴を一覧表示（フィールド変更、ステータス遷移、関連変更）
list_current_user_effort_records: [プロジェクト管理] ユーザーの実際の工数明細を取得。終了時間と開始時間の間隔は6か月を超えることはできません
list_effort_records: [プロジェクト管理] 実際の工数明細を取得
create_effort_record: [プロジェクト管理] 実際の工数を登録
list_estimated_efforts: [プロジェクト管理] 予定工数明細を取得
create_estimated_effort: [プロジェクト管理] 予定工数を登録
update_effort_record: [プロジェクト管理] 登録済みの実際の工数を更新
update_estimated_effort: [プロジェクト管理] 登録済みの予定工数を更新

パイプライン管理ツール

get_pipeline: 获取流水线详情
list_pipelines: 获取流水线列表
smart_list_pipelines: 使用自然语言时间引用进行智能流水线搜索
generate_pipeline_yaml: [流水线管理] 生成流水线 YAML 配置
create_pipeline_from_description: 根据自然语言描述创建流水线
update_pipeline: [流水线管理] 更新流水线 YAML 内容
create_pipeline_run: 创建流水线运行实例
get_latest_pipeline_run: 获取最新流水线运行实例
get_pipeline_run: 获取流水线运行详情
list_pipeline_runs: 获取流水线运行列表
list_pipeline_jobs_by_category: 按类别获取流水线执行任务
list_pipeline_job_historys: 获取流水线任务的执行历史
execute_pipeline_job_run: 手动运行流水线任务
get_pipeline_job_run_log: 获取流水线作业的执行日志
list_service_connections: 列出组织中的服务连接
create_pipeline_from_description: 自动生成 YAML 配置并创建流水线
update_pipeline: 通过 pipelineId 更新云效中现有的流水线。使用此功能更新流水线 YAML、阶段、作业等。
create_resource_member: 创建资源成员
delete_resource_member: 删除资源成员
list_resource_members: 获取资源成员列表
update_resource_member: 更新资源成员
update_resource_owner: 转移资源所有者
create_tag: 创建标签
create_tag_group: 创建标签组
list_tag_groups: 获取标签组列表
delete_tag_group: 删除标签组
update_tag_group: 更新标签组
get_tag_group: 获取标签组
delete_tag: 删除标签
update_tag: 更新标签
stop_vm_deploy_order: 停止 VM 部署单
skip_vm_deploy_machine: 跳过 VM 部署机器
retry_vm_deploy_machine: 重试 VM 部署机器
resume_vm_deploy_order: 恢复 VM 部署单
get_vm_deploy_order: 获取 VM 部署单详情
get_vm_deploy_machine_log: 获取 VM 部署机器日志

应用交付工具

create_change_order: [应用交付] 创建部署单
list_change_order_versions: [应用交付] 查看部署单版本列表
get_change_order: [应用交付] 读取部署单使用的物料和工单状态
list_change_order_job_logs: [应用交付] 查询环境部署单日志
find_task_operation_log: [应用交付] 查询部署任务执行日志，其中通常包含下游部署引擎的调度细节信息
execute_job_action: [应用交付] 操作环境部署单
list_change_orders_by_origin: [应用交付] 根据创建来源查询部署单
create_appstack_change_request: [应用交付] 创建变更请求
get_appstack_change_request_audit_items: [应用交付] 获取变更请求的审批项
list_appstack_change_request_executions: [应用交付] 列出变更请求的执行记录
list_appstack_change_request_work_items: [应用交付] 列出变更请求的工作项
cancel_appstack_change_request: [应用交付] 取消变更请求
close_appstack_change_request: [应用交付] 关闭变更请求
list_applications: [应用交付] 分页列出组织中的应用
get_application: [应用交付] 按名称获取应用详情
create_application: [应用交付] 创建新应用
update_application: [应用交付] 更新现有应用
get_latest_orchestration: [应用交付] 获取环境的最新编排
list_app_orchestration: [应用交付] 列出应用编排
create_app_orchestration: [应用交付] 创建应用编排
delete_app_orchestration: [应用交付] 删除应用编排
get_app_orchestration: [应用交付] 获取应用编排
update_app_orchestration: [应用交付] 更新应用编排
get_env_variable_groups: [应用交付] 获取环境的变量组
create_variable_group: [应用交付] 创建变量组
delete_variable_group: [应用交付] 删除变量组
get_variable_group: [应用交付] 获取变量组
update_variable_group: [应用交付] 更新变量组
get_app_variable_groups: [应用交付] 获取应用的变量组
get_app_variable_groups_revision: [应用交付] 获取应用的变量组修订版本
search_app_templates: [应用交付] 搜索应用模板
create_app_tag: [应用交付] 创建应用标签
update_app_tag: [应用交付] 更新应用标签
search_app_tags: [应用交付] 搜索应用标签
update_app_tag_bind: [应用交付] 更新应用标签绑定
create_global_var: [应用交付] 创建全局变量组
get_global_var: [应用交付] 获取全局变量组
update_global_var: [应用交付] 更新全局变量组
list_global_vars: [应用交付] 列出全局变量组
get_machine_deploy_log: [应用交付] 获取机器部署日志
add_host_list_to_host_group: [应用交付] 将主机列表添加到主机组
add_host_list_to_deploy_group: [应用交付] 将主机列表添加到部署组
list_app_release_workflows: [应用交付] 列出应用的所有发布工作流
list_app_release_workflow_briefs: [应用交付] 列出应用的发布工作流摘要
list_system_release_workflows: [应用交付] 列出所有系统发布工作流
create_system_release_workflow: [应用交付] 创建系统发布工作流
update_system_release_stage: [应用交付] 更新系统发布工作流阶段
execute_system_release_stage: [应用交付] 执行系统发布工作流阶段
get_app_release_workflow_stage: [应用交付] 获取发布工作流阶段详情
list_app_release_stage_briefs: [应用交付] 列出发布阶段摘要
update_app_release_stage: [应用交付] 更新应用发布工作流阶段
list_app_release_stage_runs: [应用交付] 列出发布阶段执行记录
execute_app_release_stage: [应用交付] 为变更请求执行发布工作流阶段
cancel_app_release_stage_execution: [应用交付] 取消发布工作流阶段执行
retry_app_release_stage_pipeline: [应用交付] 重试发布工作流阶段流水线
skip_app_release_stage_pipeline: [应用交付] 跳过发布工作流阶段流水线
list_app_release_stage_metadata: [应用交付] 列出阶段执行的集成元数据
get_app_release_stage_pipeline_run: [应用交付] 获取发布阶段流水线运行实例
pass_app_release_stage_validate: [应用交付] 通过发布工作流阶段验证
get_app_release_stage_job_log: [应用交付] 获取流水线作业执行日志
refuse_app_release_stage_validate: [应用交付] 拒绝发布工作流阶段验证

包管理工具

list_package_repositories: 获取包仓库详情列表
list_artifacts: 获取制品详情列表
get_artifact: 获取单个制品详情

测试管理工具

list_testcase_directories: [测试管理] 获取测试用例目录列表
create_testcase_directory: [测试管理] 创建测试用例目录
get_testcase_field_config: [测试管理] 获取测试用例字段配置
create_testcase: [测试管理] 创建测试用例
search_testcases: [测试管理] 搜索测试用例
get_testcase: [测试管理] 获取测试用例信息
delete_testcase: [测试管理] 删除测试用例
list_test_plans: [测试管理] 获取测试计划列表
get_test_result_list: [测试管理] 获取测试计划中的测试用例列表
update_test_result: [测试管理] 更新测试结果

联系我们

如有任何问题，请加入钉钉群“云效mcp server&智能化用户沟通2群”（ID：177120034028）。

Alibaba Cloud DevOps MCP Server DingTalk Group