AutoDL MCP Server

Codex가 AutoDL GPU 리소스를 안전하고 설명 가능하게 관리하도록 지원합니다.

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

이게 뭔가요?

AutoDL Plugin은 Codex용 커뮤니티 플러그인으로, AutoDL 공식 개발자 API와 전체 도움말 문서를 두 가지 계층의 기능으로 캡슐화합니다:

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 플러그인 매니페스트 및 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 공식 보증을 의미하지 않습니다.