AutoDL MCP Server

Codex で AutoDL GPU リソースを安全かつ説明可能に管理。

Typed MCP tools · Documentation-aware Skill · Confirmation gates · Credential redaction

これは何？

AutoDL Plugin は、Codex 向けのコミュニティプラグインで、AutoDL 公式開発者 API と完全なヘルプドキュメントを 2 層の機能としてカプセル化したものです。

1. AutoDL MCP Server：26 個のパラメータが明確で検証可能なツール。残高照会、コンテナインスタンス Pro の管理、弾性デプロイの操作、イメージ/GPU 在庫の照会、時長パックの読み取り、WeChat 通知の送信、コンテナメトリクスの取得を担当します。

2. AutoDL Skill：Agent に AutoDL の課金、データ保持、システムディスク/データディスク、イメージ、ネットワーク、SSH、CUDA、トレーニング環境、権限境界を理解させ、高リスク操作の前に正しいフローを実行させます。

これは単なる「HTTP インターフェース転送器」ではありません。プラグインは読み取り専用、状態変更、課金、破壊的操作を区別し、実際の作成、起動、シャットダウン、リリース、スケーリング、削除、メッセージ送信の前に確認ゲートを通過する必要があります。

[!IMPORTANT] これはコミュニティ統合であり、AutoDL 公式製品ではありません。実際のサービス能力、価格、在庫、割り当て、ルールは AutoDL 公式サイト と 公式ドキュメント に準拠します。

Related MCP server: AutoDL MCP Server

特長

• 26 個の typed MCP ツール：各インターフェースに独立した名前、パラメータ説明、入力検証があります。

• 安全な確認ゲート：変更操作は confirm=false の場合、リクエストプレビューのみを返し、AutoDL にアクセスしません。

• 認証情報の保護：インスタンス詳細はデフォルトで root_password と jupyter_token をマスクします。

• Token の分離：開発者 Token はローカル環境からのみ読み取られ、ソースコード、ツール出力、テストフィクスチャには入りません。

• 完全なドキュメント認識：公式ヘルプサイトの 103/103 ページ、463 の検索エントリをインデックス化。

• ドキュメントドリフトチェック：公式ディレクトリを再取得し、ページステータスと SHA-256 マニフェストを生成可能。

• 実際の MCP テスト：stdio ハンドシェイクで全ツールを呼び出し、内部関数のみのテストではありません。

• 本番環境での読み取り専用検証：残高、Pro インスタンスリスト、Pro イメージリストは実際の AutoDL API で検証済み。

アーキテクチャ

flowchart LR
    U["User / Codex"] --> S["AutoDL Skill"]
    S -->|"选择工具与安全流程"| M["Typed MCP Server"]
    M --> G{"Confirmation gate"}
    G -->|"只读"| A["AutoDL Developer API"]
    G -->|"变更且 confirm=true"| A
    G -->|"confirm=false"| P["Request preview only"]
    A --> R["Redaction + structured result"]
    R --> U
    D["103 official docs pages"] --> S

クイックスタート

1. クローンしてインストール

git clone https://github.com/wuzihuang/AUTODL-PLUGIN.git
cd AUTODL-PLUGIN
npm install

要件：Node.js 20 以上。

2. AutoDL Token の設定

AutoDL コンソールのアカウント設定で開発者 Token を取得し、ローカル環境ファイルを作成します：

cp .env.example .env

.env を編集：

AUTODL_TOKEN=你的开发者Token

.env は Git で無視されています。実際の Token を README、設定例、Issue、ログ、コミット記録に書き込まないでください。

.env を作成せずに、Codex を起動する環境で提供することもできます：

export AUTODL_TOKEN='你的开发者Token'

3. Codex でプラグインを読み込む

ローカルプラグインをサポートする Codex でこのリポジトリのルートディレクトリを選択します。Codex は以下を通じて：

• .codex-plugin/plugin.json で AutoDL Skill を検出；

• .mcp.json でローカル AutoDL MCP Server を起動。

クライアントがローカルプラグインをまだサポートしていない場合は、MCP を手動で設定できます：

{
  "mcpServers": {
    "autodl": {
      "command": "bash",
      "args": ["/absolute/path/AUTODL-PLUGIN/scripts/start-mcp.sh"],
      "cwd": "/absolute/path/AUTODL-PLUGIN"
    }
  }
}

Skill は単独でインストールすることもできます：

cp -R skills/autodl ~/.codex/skills/autodl

4. こんなふうに聞いてみる

• 「AutoDL の残高を確認して、金額を人民元に換算して。」

• 「Pro インスタンスを一覧表示して、まだ課金されているものを教えて。」

• 「westDC2 の RTX 4090 弾性デプロイ在庫を照会して。」

• 「シングル GPU インスタンスを作成したい。先にパラメータと費用リスクのプレビューを出して、直接作成しないで。」

• 「このインスタンスの環境を保存する前に、別途バックアップすべきデータは何？」

• 「nvidia-smi の CUDA バージョンと環境内の CUDA が違うのはなぜ？」

MCP ツール一覧

アカウントとストレージ

コンテナインスタンス Pro

弾性デプロイ

通知とモニタリング

完全なフィールド、インターフェースパス、地域コード、GPU 仕様、ベースイメージの例は API Reference を参照してください。

権限マトリックス

API が「現在のリソースへのアクセス権限がありません」を返した場合、プラグインはそれを認証または製品権限の問題として解釈し、MCP 障害として誤って報告しません。

セキュリティモデル

確認ゲート

費用が発生する、状態を変更する、ワークロードを停止する、データを削除する、外部メッセージを送信するすべてのツールには confirm パラメータがあります：

confirm=false  → 返回方法、路径、目标与参数预览，不发送网络请求
confirm=true   → 执行真实 AutoDL API 请求

Agent は実行前にユーザーに以下を説明する必要があります：

• 正確なインスタンス、デプロイ、コンテナ ID；

• GPU 数、インスタンス数、レプリカ数；

• 価格上限と課金への影響；

• トレーニングやサービスを中断するかどうか；

• システムディスクとデータディスクをバックアップ済みかどうか。

データと認証情報

• root_password、jupyter_token はデフォルトで [REDACTED] と表示されます。

• ローカルメトリクスリクエストは AutoDL 開発者 Token を保持しません。

• Token は MCP の構造化結果やエラー結果に表示されません。

• インスタンスのリリースとデプロイの削除は destructive としてマークされます。

• Pro インスタンスのリリースフローでは先にシャットダウンが必要です。

AutoDL 利用上の境界

• リソースを仮想通貨マイニングに使用することは固く禁止されています。

• ローカルシステムディスクとデータディスクには冗長性の信頼性保証がなく、重要なデータは必ずバックアップする必要があります。

• マッピングされたサービスアドレスは非公開に保ち、AutoDL カスタムサービス規約を遵守する必要があります。

• 現在の価格、キャンペーン、在庫、地域、割り当て、ポリシー日付はリアルタイムで確認する必要があります。

詳細なルールは Operations Guide と Security Policy を参照してください。

主要な技術的詳細

• API Host：https://api.autodl.com

• 認証：Authorization: <raw token>、Bearer は付けない

• 成功判定：code === "Success"

• 金額：API 内の関連する整数を 1000 で割った値が人民元

• CUDA エンコーディング：例 118 は CUDA 11.8 を表す

• Pro 状態/詳細：公式ドキュメントでは GET + JSON body と定義

• GPU 在庫：単一 GPU スケジューリング基準であり、複数 GPU が同一ホスト上にあることを証明するものではない

• 専用 NFS：mountable=1；通常ファイルストレージに戻す：mountable=-1

設定

テスト

全量自動テスト

npm test

テスト内容：

• Codex plugin manifest と MCP 設定の検証；

• Skill frontmatter、参照ファイル、26/26 ツールカバレッジ；

• 103/103 公式ドキュメントページマニフェスト；

• MCP stdio 初期化とツール検出；

• 26/26 ツールの完全な mock 呼び出し；

• HTTP メソッド、パス、query、GET JSON body；

• 未確認の変更はネットワーク送信しない；

• AutoDL ビジネスエラーのマッピング；

• Token の漏洩なし；

• インスタンス認証情報のデフォルトマスク；

• ローカルメトリクスリクエストは Token を保持しない。

本番環境読み取り専用テスト

npm run test:live

このコマンドは残高、インスタンス、イメージ、デプロイ、ブラックリストなどの情報を読み取るだけで、リソースを作成または変更しません。企業インターフェースに権限がない場合は SKIP/PERMISSION とマークされます。

現在の検証記録：

• アカウント残高：HTTP 200

• Pro インスタンスリスト：HTTP 200

• Pro プライベートイメージリスト：HTTP 200

• 弾性デプロイ：テストアカウントにアクセス権限がないため、安全にスキップ

• Pro 状態/詳細：テストアカウントに現存インスタンスがないため、条件付きでスキップ

詳細は 完全なテストレポート を参照してください。

公式ドキュメントカバレッジ

ドキュメント更新スクリプトは AutoDL の MkDocs 検索インデックスを読み取り、ページごとに本文をチェックし、以下を生成します：

• ページごとのドキュメントインデックス

• ドキュメント監査マニフェスト

現在のスナップショット：

更新：

npm run docs:refresh
npm test

リポジトリは AutoDL ドキュメントをサイト全体でコピーせず、ルートインデックス、要約ルール、ハッシュメタデータのみを保存します。価格、認証、在庫、割り当て、ポリシーに関わる場合は公式ページを再確認してください。

プロジェクト構造

AUTODL-PLUGIN/
├── .codex-plugin/plugin.json      # Codex 插件清单
├── .mcp.json                      # MCP 自动发现配置
├── assets/                        # Logo 与 README Banner
├── mcp/
│   ├── src/                       # MCP Server 与 AutoDL HTTP Client
│   └── test/                      # 全工具契约测试、只读实时测试
├── skills/autodl/
│   ├── SKILL.md                   # Agent 工作流与安全规则
│   ├── references/                # API、运维规则、文档索引
│   └── scripts/                   # 文档刷新与 Skill 校验
├── scripts/
│   ├── start-mcp.sh               # 插件 MCP 启动入口
│   └── validate-plugin.mjs        # 插件与敏感信息校验
├── docs/TEST_REPORT.md
└── .github/workflows/ci.yml

開発と貢献

新しい公開インターフェース、レスポンスサンプル、権限説明、ドキュメントドリフト修正を歓迎します。まず CONTRIBUTING.md をお読みください。

基本的なフロー：

npm install
npm test

新しい状態変更インターフェースを追加する場合は必ず：

1. 独立した typed tool を使用；

2. confirm プレビューゲートを追加；

3. 課金、中断、データへの影響を説明；

4. mock 契約テストを追加；

5. 実際のアカウントで破壊的な CI テストを実行しない。

License

MIT

AutoDL の名称、サービス、公式ドキュメントはその権利者に帰属します。本プロジェクトはコミュニティ統合のみを提供し、AutoDL 公式の推薦を意味するものではありません。