alibabacloud-devops-mcp-server について
alibabacloud-devops-mcp-server は、Alibaba Cloud の Yunxiao プラットフォーム向け MCP サーバーです。AI アシスタントからリポジトリ、プロジェクト、パイプライン、アーティファクトリポジトリを扱えます。Yunxiao で コード レビューやタスク管理を行う企業の開発チームを想定しています。
主な機能
- 01組織、コード、プロジェクト、パイプラインなど 7 のツールセット
- 02Codeup のリポジトリ、ブランチ、マージリクエスト操作
- 03プロジェクトの作業項目、フィールド、コメント管理
- 04stdio、SSE、Streamable HTTP のトランスポートに対応
- 05ツールセットの指定による公開ツールの絞り込み
活用シーン
- 01AI アシスタントで作業項目を読み取り、マージリクエストを提出する
- 02パイプライン構成やデプロイ状況を照会する
- 03コード管理ツールのみを有効にしてツール数を減らす
MCP 対応
MCP サーバーとして、Yunxiao の組織、コード、プロジェクト、パイプライン、アプリケーションデリバリー、アーティファクト、テスト管理 API を MCP クライアントに公開します。公式のホスト型リモート MCP エンドポイントも提供されています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
199掲載時のツール一覧 · 3 週間前に更新
このツールにパラメーターはありません。
詳細
英語 | 中国語
alibabacloud-devops-mcp-server
AlibabaCloud Devops MCP サーバーは、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 Central Station OpenAPI(
https://openapi-rdc.aliyuncs.com)を呼び出します。追加の設定は不要です- Region エディション(組織固有のドメイン)をご利用の場合は、追加の環境変数
YUNXIAO_API_BASE_URLに Yunxiao インスタンスの URL を設定してください。例:https://your-org.devops.aliyuncs.com。詳細については、上記の「Region エディションの設定」セクションをご覧ください- この方法では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
Region/インスタンスの OpenAPI ベース URL:
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(デフォルト)またはMARKDOWNlist_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: [application delivery] デプロイ依頼を作成list_change_order_versions: [application delivery] デプロイ依頼のバージョン一覧を表示get_change_order: [application delivery] デプロイ依頼で使用されている資材と作業項目の状態を取得list_change_order_job_logs: [application delivery] 環境デプロイ依頼のログを検索find_task_operation_log: [application delivery] デプロイタスクの実行ログを検索。通常、下流のデプロイエンジンのスケジュール詳細が含まれますexecute_job_action: [application delivery] 環境デプロイ依頼を操作list_change_orders_by_origin: [application delivery] 作成元に基づいてデプロイ依頼を検索create_appstack_change_request: [application delivery] 変更リクエストを作成get_appstack_change_request_audit_items: [application delivery] 変更リクエストの承認項目を取得list_appstack_change_request_executions: [application delivery] 変更リクエストの実行記録を一覧表示list_appstack_change_request_work_items: [application delivery] 変更リクエストの作業項目を一覧表示cancel_appstack_change_request: [application delivery] 変更リクエストをキャンセルclose_appstack_change_request: [application delivery] 変更リクエストをクローズlist_applications: [application delivery] 組織内のアプリケーションをページネーション付きで一覧表示get_application: [application delivery] 名前でアプリケーションの詳細を取得create_application: [application delivery] 新しいアプリケーションを作成update_application: [application delivery] 既存のアプリケーションを更新get_latest_orchestration: [application delivery] 環境の最新のオーケストレーションを取得list_app_orchestration: [application delivery] アプリケーションのオーケストレーションを一覧表示create_app_orchestration: [application delivery] アプリケーションのオーケストレーションを作成delete_app_orchestration: [application delivery] アプリケーションのオーケストレーションを削除get_app_orchestration: [application delivery] アプリケーションのオーケストレーションを取得update_app_orchestration: [application delivery] アプリケーションのオーケストレーションを更新get_env_variable_groups: [application delivery] 環境の変数グループを取得create_variable_group: [application delivery] 変数グループを作成delete_variable_group: [application delivery] 変数グループを削除get_variable_group: [application delivery] 変数グループを取得update_variable_group: [application delivery] 変数グループを更新get_app_variable_groups: [application delivery] アプリケーションの変数グループを取得get_app_variable_groups_revision: [application delivery] アプリケーションの変数グループのリビジョンを取得search_app_templates: [application delivery] アプリケーションテンプレートを検索create_app_tag: [application delivery] アプリケーションタグを作成update_app_tag: [application delivery] アプリケーションタグを更新search_app_tags: [application delivery] アプリケーションタグを検索update_app_tag_bind: [application delivery] アプリケーションタグの関連付けを更新create_global_var: [application delivery] グローバル変数グループを作成get_global_var: [application delivery] グローバル変数グループを取得update_global_var: [application delivery] グローバル変数グループを更新list_global_vars: [application delivery] グローバル変数グループを一覧表示get_machine_deploy_log: [application delivery] マシンのデプロイログを取得add_host_list_to_host_group: [application delivery] ホスト一覧をホストグループに追加add_host_list_to_deploy_group: [application delivery] ホスト一覧をデプロイグループに追加list_app_release_workflows: [application delivery] アプリケーションのすべてのリリースワークフローを一覧表示list_app_release_workflow_briefs: [application delivery] アプリケーションのリリースワークフローの概要を一覧表示list_system_release_workflows: [application delivery] すべてのシステムリリースワークフローを一覧表示create_system_release_workflow: [application delivery] システムリリースワークフローを作成update_system_release_stage: [application delivery] システムリリースワークフローのステージを更新execute_system_release_stage: [application delivery] システムリリースワークフローのステージを実行get_app_release_workflow_stage: [application delivery] リリースワークフローのステージの詳細を取得list_app_release_stage_briefs: [application delivery] リリースステージの概要を一覧表示update_app_release_stage: [application delivery] アプリケーションリリースワークフローのステージを更新list_app_release_stage_runs: [application delivery] リリースステージの実行記録を一覧表示execute_app_release_stage: [application delivery] 変更リクエストのリリースワークフローステージを実行cancel_app_release_stage_execution: [application delivery] リリースワークフローステージの実行をキャンセルretry_app_release_stage_pipeline: [application delivery] リリースワークフローステージのパイプラインを再試行skip_app_release_stage_pipeline: [application delivery] リリースワークフローステージのパイプラインをスキップlist_app_release_stage_metadata: [application delivery] ステージ実行の統合メタデータを一覧表示get_app_release_stage_pipeline_run: [application delivery] リリースステージのパイプライン実行インスタンスを取得pass_app_release_stage_validate: [application delivery] リリースワークフローステージの検証を承認get_app_release_stage_job_log: [application delivery] パイプラインジョブの実行ログを取得refuse_app_release_stage_validate: [application delivery] リリースワークフローステージの検証を拒否
パッケージ管理ツール
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:[テスト管理] テスト結果を更新します
お問い合わせ
ご質問がある場合は、DingTalk グループ「云效mcp server&智能化用户沟通2群」(ID:177120034028)にご参加ください。

関連リンク
リージョン IP 許可リスト向けのクライアント IP 転送
リージョン OpenAPI への HTTP リクエストでは、イングレスから提供された X-Real-IP を、検証済みの単一アドレスとして X-Forwarded-For と X-Real-IP に転送します。これには、トークンの確認と添付ファイルのアップロードも含まれます。アドレスはリクエストごとに適用され、MCP セッションには保存されません。X-Real-IP がない場合や無効な場合は、ソケットのピアアドレスが使用されます。MCP は受信した X-Forwarded-For チェーンからアドレスを選択しません。Stdio と中央 OpenAPI へのリクエストでは、これらのヘッダーは追加されません。
ホスト型デプロイでは、イングレスが X-Real-IP を実際のクライアントアドレスで上書きし、MCP への直接アクセスを制限することを前提としています。プロキシアドレスのリストや Express の trust proxy 設定は必要ありません。この機能を使用するセルフホスト型の HTTP デプロイでは、同じイングレスの要件を適用する必要があります。このヘッダー自体は、アドレスを認証するものではありません。リモート AI プロバイダーの送信元 IP が、イングレスで観測されるクライアントアドレスとなり、人間のユーザーのワークステーション IP とは異なる場合があります。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。