AutoDL MCP Server

Lass Codex AutoDL-GPU-Ressourcen sicher und nachvollziehbar verwalten.

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

Was ist das?

AutoDL Plugin ist ein Community-Plugin für Codex, das die offizielle AutoDL-Entwickler-API zusammen mit der vollständigen Hilfedokumentation in zwei Ebenen kapselt:

1. AutoDL MCP Server: 26 Tools mit klaren Parametern und Validierung, zuständig für die Abfrage des Guthabens, die Verwaltung von Container-Instanzen Pro, die Bedienung von Elastic Deployments, die Abfrage von Image-/GPU-Beständen, das Lesen von Zeitpaketen, das Senden von WeChat-Benachrichtigungen und das Abrufen von Container-Metriken.

2. AutoDL Skill: Versetzt den Agenten in die Lage, die Abrechnung, Datenaufbewahrung, System-/Datenträger, Images, Netzwerk, SSH, CUDA, Trainingsumgebung und Berechtigungsgrenzen von AutoDL zu verstehen und vor risikoreichen Operationen den korrekten Ablauf auszuführen.

Es ist kein einfacher „HTTP-Interface-Forwarder". Das Plugin unterscheidet zwischen schreibgeschützten, statusändernden, kostenpflichtigen und destruktiven Operationen; vor dem tatsächlichen Erstellen, Einschalten, Ausschalten, Freigeben, Skalieren, Löschen oder Senden von Nachrichten muss ein Bestätigungs-Gate durchlaufen werden.

[!IMPORTANT] Dies ist eine Community-Integration, kein offizielles AutoDL-Produkt. Maßgeblich für tatsächliche Servicefähigkeiten, Preise, Bestände, Kontingente und Regeln sind die AutoDL-Website und die offizielle Dokumentation.

Related MCP server: AutoDL MCP Server

Highlights

• 26 typisierte MCP-Tools: Jede Schnittstelle hat einen eigenen Namen, Parameterbeschreibungen und Eingabevalidierung.

• Sicherheits-Bestätigungs-Gates: Änderungsoperationen geben bei confirm=false nur eine Anfragevorschau zurück, ohne auf AutoDL zuzugreifen.

• Credential-Schutz: Instanzdetails maskieren standardmäßig root_password und jupyter_token.

• Token-Isolation: Das Entwickler-Token wird nur aus der lokalen Umgebung gelesen und gelangt nicht in Quellcode, Tool-Ausgaben oder Test-Fixtures.

• Vollständige Dokumentationskenntnis: Indexiert 103/103 Seiten der offiziellen Hilfeseite sowie 463 Sucheinträge.

• Dokumentations-Drift-Prüfung: Kann das offizielle Verzeichnis erneut abrufen und einen Seitenstatus sowie eine SHA-256-Liste erzeugen.

• Echte MCP-Tests: Ruft alle Tools über einen stdio-Handshake auf, statt nur interne Funktionen zu testen.

• Schreibgeschützte Verifikation in der Produktion: Guthaben, Pro-Instanzliste und Pro-Imageliste wurden bereits über die echte AutoDL-API verifiziert.

Architektur

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

Schnellstart

1. Klonen und installieren

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

Voraussetzung: Node.js 20 oder höher.

2. AutoDL-Token konfigurieren

Hole das Entwickler-Token in den Kontoeinstellungen der AutoDL-Konsole und erstelle dann eine lokale Umgebungsdatei:

cp .env.example .env

Bearbeite .env:

AUTODL_TOKEN=你的开发者Token

.env wird von Git ignoriert. Schreibe niemals echte Tokens in README, Konfigurationsbeispiele, Issues, Logs oder Commits.

Alternativ kannst du auch auf .env verzichten und das Token in der Umgebung bereitstellen, in der Codex gestartet wird:

export AUTODL_TOKEN='你的开发者Token'

3. Plugin in Codex laden

Wähle in Codex, sofern lokale Plugins unterstützt werden, das Repository-Root-Verzeichnis. Codex wird dann:

• über .codex-plugin/plugin.json den AutoDL-Skill entdecken;

• über .mcp.json den lokalen AutoDL-MCP-Server starten.

Falls dein Client lokale Plugins noch nicht unterstützt, kannst du MCP manuell konfigurieren:

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

Der Skill kann auch separat installiert werden:

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

4. Probiere zum Beispiel diese Fragen

• „Zeig mir mein AutoDL-Guthaben, den Betrag umgerechnet in chinesische Yuan."

• „Liste meine Pro-Instanzen auf und sag mir, welche noch abgerechnet werden."

• „Frag den Elastic-Deployment-Bestand für RTX 4090 in westDC2 ab."

• „Ich möchte eine Single-GPU-Instanz erstellen. Gib mir zuerst Parameter und Kostenrisiko-Vorschau, erstelle aber nichts direkt."

• „Bevor ich die Umgebung dieser Instanz speichere, welche Daten muss ich zusätzlich separat sichern?"

• „Warum unterscheidet sich die CUDA-Version in nvidia-smi von der CUDA in der Umgebung?"

MCP-Tool-Übersicht

Konto und Speicher

Container-Instanzen Pro

Elastic Deployment

Benachrichtigung und Monitoring

Vollständige Felder, API-Pfade, Regionscodes, GPU-Spezifikationen und Basis-Image-Beispiele findest du in der API-Referenz.

Berechtigungsmatrix

Wenn die API „keinen Zugriff auf die aktuelle Ressource" zurückgibt, interpretiert das Plugin dies als Authentifizierungs- oder Produktberechtigungsproblem, statt es fälschlich als MCP-Fehler zu melden.

Sicherheitsmodell

Bestätigungs-Gates

Alle Tools, die Kosten verursachen, den Status ändern, Workloads stoppen, Daten löschen oder externe Nachrichten senden, haben einen confirm-Parameter:

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

Der Agent sollte dem Benutzer vor der Ausführung weiterhin Folgendes erläutern:

• die genaue Instanz-, Deployment- oder Container-ID;

• die Anzahl der GPUs, Instanzen oder Replicas;

• die Preisobergrenze und die Abrechnungsauswirkungen;

• ob Training oder Dienste unterbrochen werden;

• ob Systemdatenträger und Datenträger bereits gesichert wurden.

Daten und Anmeldeinformationen

• root_password und jupyter_token werden standardmäßig als [REDACTED] angezeigt.

• Lokale Metrikanfragen übertragen kein AutoDL-Entwickler-Token.

• Tokens erscheinen nicht in strukturierten MCP-Ergebnissen oder Fehlerergebnissen.

• Das Freigeben von Instanzen und das Löschen von Deployments sind als destruktiv markiert.

• Der Freigabeprozess für Pro-Instanzen erfordert ein vorheriges Ausschalten.

AutoDL-Nutzungsgrenzen

• Die Nutzung der Ressourcen für Kryptowährungs-Mining ist strengstens untersagt.

• Lokale Systemdatenträger und Datenträger bieten keine Redundanz-Zuverlässigkeitsgarantie; wichtige Daten müssen gesichert werden.

• Gemappte Service-Adressen sollten privat gehalten werden und das AutoDL-Custom-Service-Protokoll einhalten.

• Aktuelle Preise, Aktionen, Bestände, Regionen, Kontingente und Richtliniendaten müssen in Echtzeit überprüft werden.

Weitere Regeln findest du im Operations Guide und in der Security Policy.

Wichtige technische Details

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

• Authentifizierung: Authorization: <raw token>, ohne Bearer

• Erfolgskriterium: code === "Success"

• Beträge: Die relevanten Ganzzahlen in der API durch 1000 teilen, um chinesische Yuan zu erhalten

• CUDA-Codierung: z. B. 118 bedeutet CUDA 11.8

• Pro-Status/-Details: In der offiziellen Dokumentation als GET + JSON body definiert

• GPU-Bestand: Nach Single-GPU-Scheduling-Maßstab; beweist nicht, dass mehrere GPUs auf demselben Host liegen

• Dediziertes NFS: mountable=1; zurück zu normalem Dateispeicher: mountable=-1

Konfiguration

Tests

Vollständige automatische Tests

npm test

Die Tests umfassen:

• Validierung des Codex-Plugin-Manifests und der MCP-Konfiguration;

• Skill-Frontmatter, referenzierte Dateien und 26/26-Tool-Abdeckung;

• 103/103-Liste der offiziellen Dokumentationsseiten;

• MCP-stdio-Initialisierung und Tool-Erkennung;

• 26/26 vollständige Mock-Aufrufe der Tools;

• HTTP-Methode, Pfad, Query und GET-JSON-Body;

• Keine Netzwerkaufrufe bei unbestätigten Änderungen;

• Mapping von AutoDL-Geschäftsfehlern;

• Kein Token-Leak;

• Standardmäßige Maskierung von Instanz-Anmeldeinformationen;

• Lokale Metrikanfragen übertragen kein Token.

Schreibgeschützte Tests in der Produktion

npm run test:live

Dieser Befehl liest nur Guthaben, Instanzen, Images, Deployments und Blacklists usw. und erstellt oder ändert keine Ressourcen. Unternehmensschnittstellen ohne Berechtigung werden als SKIP/PERMISSION markiert.

Aktuelle Verifizierungsaufzeichnungen:

• Kontoguthaben: HTTP 200

• Pro-Instanzliste: HTTP 200

• Pro-private-Imageliste: HTTP 200

• Elastic Deployment: Testkonto ohne Zugriffsberechtigung, sicher übersprungen

• Pro-Status/-Details: Testkonto ohne vorhandene Instanzen, bedingt übersprungen

Details findest du im vollständigen Testbericht.

Offizielle Dokumentationsabdeckung

Das Dokumentations-Aktualisierungsskript liest den MkDocs-Suchindex von AutoDL, prüft den Inhalt jeder Seite und erzeugt:

• Seitenweiser Dokumentationsindex

• Dokumentations-Auditliste

Aktueller Snapshot:

Aktualisierung:

npm run docs:refresh
npm test

Das Repository kopiert nicht die gesamte AutoDL-Dokumentation, sondern speichert nur Routing-Index, Zusammenfassungsregeln und Hash-Metadaten. Bei Preisen, Authentifizierung, Beständen, Kontingenten und Richtlinien sollten die offiziellen Seiten erneut eingesehen werden.

Projektstruktur

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

Entwicklung und Beiträge

Neue öffentliche Schnittstellen, Antwortbeispiele, Berechtigungshinweise und Dokumentations-Drift-Fixes sind willkommen. Bitte lies zuerst CONTRIBUTING.md.

Grundlegender Ablauf:

npm install
npm test

Bei neuen Statusänderungsschnittstellen ist Folgendes erforderlich:

1. Verwendung eines separaten typisierten Tools;

2. Einbindung eines confirm-Vorschau-Gates;

3. Beschreibung der Abrechnungs-, Unterbrechungs- und Datenauswirkungen;

4. Hinzufügen von Mock-Vertragstests;

5. Keine destruktiven CI-Tests mit echten Konten.

Lizenz

MIT

Der Name AutoDL, die Dienste und die offizielle Dokumentation gehören ihren jeweiligen Rechteinhabern. Dieses Projekt bietet lediglich eine Community-Integration und stellt keine offizielle Unterstützung durch AutoDL dar.