AutoDL MCP Server

Позволяет Codex безопасно и объяснимо управлять GPU-ресурсами AutoDL.

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

Что это такое?

AutoDL Plugin — это плагин сообщества для Codex, который оборачивает официальный API разработчика AutoDL и полную справочную документацию в два уровня возможностей:

1. AutoDL MCP Server: 26 инструментов с чёткими параметрами и проверкой входных данных, отвечающих за запрос баланса, управление экземплярами Container Instance Pro, работу с Elastic Deployment, запрос образов/наличия GPU, чтение пакетов времени, отправку WeChat-уведомлений и получение метрик контейнеров.

2. AutoDL Skill: позволяет агенту понимать биллинг AutoDL, хранение данных, системный/дисковый раздел данных, образы, сеть, SSH, CUDA, среду обучения и границы прав, а также выполнять правильные процедуры перед высокорискованными операциями.

Это не простой «пересыльщик HTTP-интерфейсов». Плагин различает операции только для чтения, изменения состояния, биллинга и деструктивные операции; перед фактическим созданием, включением, выключением, освобождением, масштабированием, удалением или отправкой сообщений обязательно прохождение confirmation gate.

[!IMPORTANT] Это интеграция сообщества, а не официальный продукт AutoDL. Фактические возможности сервиса, цены, наличие, квоты и правила определяются официальным сайтом AutoDL и официальной документацией.

Related MCP server: AutoDL MCP Server

Ключевые особенности

• 26 typed MCP-инструментов: у каждого интерфейса есть собственное имя, описание параметров и проверка входных данных.

• Безопасные confirmation gates: операции изменения при confirm=false возвращают только предпросмотр запроса и не обращаются к AutoDL.

• Защита учётных данных: детали экземпляра по умолчанию скрывают root_password и jupyter_token.

• Изоляция токена: токен разработчика читается только из локального окружения и не попадает в исходный код, вывод инструментов или тестовые фикстуры.

• Полное знание документации: проиндексированы 103/103 страницы официального справочного сайта, 463 поисковых записи.

• Проверка расхождения документации: можно заново получить официальный каталог и сгенерировать статус страниц и манифест SHA-256.

• Реальные MCP-тесты: все инструменты вызываются через stdio-рукопожатие, а не только тестируются внутренние функции.

• Проверка только для чтения в продакшене: баланс, список Pro-экземпляров и список Pro-образов уже проверены через реальный API AutoDL.

Архитектура

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

Получите токен разработчика в настройках аккаунта консоли AutoDL, затем создайте локальный файл окружения:

cp .env.example .env

Отредактируйте .env:

AUTODL_TOKEN=你的开发者Token

.env игнорируется Git. Не записывайте реальный токен в README, примеры конфигурации, Issues, логи или коммиты.

Можно также не создавать .env, а указать его в окружении, в котором запускается Codex:

export AUTODL_TOKEN='你的开发者Token'

3. Загрузка плагина в Codex

В Codex, поддерживающем локальные плагины, выберите корневой каталог этого репозитория. Codex обнаружит:

• AutoDL Skill через .codex-plugin/plugin.json;

• локальный AutoDL MCP Server через .mcp.json.

Если ваш клиент пока не поддерживает локальные плагины, можно настроить 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-экземпляры и скажи, какие ещё тарифицируются.»

• «Проверь наличие Elastic Deployment для RTX 4090 в westDC2.»

• «Я хочу создать одно-карточный экземпляр, сначала покажи параметры и предпросмотр рисков по стоимости, не создавай напрямую.»

• «Перед сохранением окружения этого экземпляра какие данные мне нужно дополнительно отдельно забэкапить?»

• «Почему версия CUDA в nvidia-smi отличается от CUDA в окружении?»

Обзор MCP-инструментов

Аккаунт и хранилище

Container Instance Pro

Elastic Deployment

Уведомления и мониторинг

Полные поля, пути интерфейсов, коды регионов, спецификации GPU и примеры базовых образов см. в API Reference.

Матрица прав

Если API возвращает «нет прав доступа к текущему ресурсу», плагин интерпретирует это как проблему аутентификации или прав на продукт, а не ошибочно сообщает о сбое MCP.

Модель безопасности

Confirmation gates

Все инструменты, которые создают расходы, изменяют состояние, останавливают рабочие нагрузки, удаляют данные или отправляют внешние сообщения, имеют параметр confirm:

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

Агент всё равно должен перед выполнением объяснить пользователю:

• точный ID экземпляра, развёртывания или контейнера;

• количество GPU, экземпляров или реплик;

• верхний предел цены и влияние на биллинг;

• будет ли прервано обучение или сервис;

• были ли забэкаплены системный диск и диск данных.

Данные и учётные данные

• root_password, jupyter_token по умолчанию отображаются как [REDACTED].

• Запросы локальных метрик не несут токен разработчика AutoDL.

• Токен не появляется в структурированных результатах 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: по методу планирования одной карты, не может доказать, что несколько карт находятся на одном хосте

• Выделенный NFS: mountable=1; переключение обратно на обычное файловое хранилище: mountable=-1

Конфигурация

Тестирование

Полное автоматическое тестирование

npm test

Тесты включают:

• проверку манифеста плагина Codex и конфигурации MCP;

• frontmatter Skill, файлы ссылок и покрытие 26/26 инструментов;

• список 103/103 страниц официальной документации;

• инициализацию MCP stdio и обнаружение инструментов;

• полные mock-вызовы 26/26 инструментов;

• HTTP-методы, пути, query и GET JSON body;

• неподтверждённые изменения не отправляют сетевые запросы;

• сопоставление бизнес-ошибок AutoDL;

• отсутствие утечки токена;

• скрытие учётных данных экземпляра по умолчанию;

• запросы локальных метрик не несут токен.

Тесты только для чтения в продакшене

npm run test:live

Эта команда только читает баланс, экземпляры, образы, развёртывания и чёрные списки и не создаёт и не изменяет ресурсы. Если у корпоративных интерфейсов нет прав, они помечаются как SKIP/PERMISSION.

Текущие записи проверки:

• Баланс аккаунта: HTTP 200

• Список Pro-экземпляров: HTTP 200

• Список приватных образов Pro: HTTP 200

• Elastic Deployment: тестовый аккаунт не имеет прав доступа, безопасно пропущено

• Статус/детали Pro: у тестового аккаунта нет существующих экземпляров, пропущено по условию

Подробности см. в полном отчёте о тестировании.

Покрытие официальной документации

Скрипт обновления документации читает поисковый индекс MkDocs AutoDL, проверяет содержимое каждой страницы и генерирует:

• Постраничный индекс документации

• Манифест аудита документации

Текущий снимок:

Обновление:

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.