AlibabaCloud DevOps MCP
公式Yunxiao MCP Serverは、AIアシスタントがYunxiaoプラットフォームと対話する機能を提供します。
Alibaba Cloud Dev Ops MCPで何ができますか?
- 作業項目の検索と表示 —
search_workitemsを使用してプロジェクト全体の作業項目を検索し、その詳細、コメント、添付ファイル、アクティビティ履歴を確認します。 - マージリクエストとコードの管理 — マージリクエストの一覧表示、作成、コメント (
list_change_request、create_change_request_comment)、リポジトリのファイルツリーの参照、ブランチの比較を行います。 - パイプラインの実行と検査 —
list_pipeline_runsとget_pipeline_job_run_logを使用して、パイプラインの実行をトリガーし、実行ログを取得し、実行ステータスを照会します。 - アプリケーションデプロイの処理 —
execute_app_release_stageを使用して、デプロイ変更オーダーの作成、デプロイログの表示、リリースワークフローステージの管理を行います。 - テストケースとテスト計画の管理 —
search_testcasesとupdate_test_resultを使用して、テストケースの検索、テスト計画の作成、テスト結果の更新を行います。 - 組織構造の参照 —
get_organization_departmentsとsearch_organization_membersを使用して、部門、メンバー、ロールを検索します。
ドキュメント
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: マージリクエストを作成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: 特定の作業項目に関連付け可能な作業項目タイプを一覧表示get_work_item_type_field_config: 特定の作業項目タイプのフィールド設定を取得get_work_item_workflow: 特定の作業項目タイプのワークフロー情報を取得list_work_item_comments: 特定の作業項目のコメントを一覧表示create_work_item_comment: 特定の作業項目にコメントを作成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でYunxiaoの既存パイプラインを更新。パイプライン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: [テスト管理] テスト結果の更新
お問い合わせ
ご質問がある場合は、Alibaba Cloud DevOpsディスカッショングループ(134400004101)にご参加ください。
