Wecandeo VideoPack v4 MCP Server

Wecandeo VideoPack v4 API를 위한 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Claude Code, Cursor 등 MCP 클라이언트에서 위캔디오 비디오팩 전반 기능(업로드 · 인코딩 · 배포 · 미디어 보관함)을 Stdio 모드로 사용할 수 있습니다.

• 홈페이지: https://www.wecandeo.com

• API 가이드: https://support.wecandeo.com/v4.0

위캔디오 비디오팩 MCP는 기능별로 세 개의 서버로 구성됩니다.

• @wecandeo/mcp-videopack-v4 — 비디오팩 전반 기능 (본 서버)

• @wecandeo/mcp-analytics-v4 — 통계

• @wecandeo/mcp-ai-v4 — AI 기능

설치 및 실행

환경 변수

• API 키 확인 방법: 비디오팩 API 시작하기 가이드를 참고하세요.

npx로 실행 (권장)

WECANDEO_API_KEY=your_key npx @wecandeo/mcp-videopack-v4

Claude Desktop / Cursor 설정

claude_desktop_config.json 또는 .cursor/mcp.json:

{
  "mcpServers": {
    "wecandeo-v4": {
      "command": "npx",
      "args": ["-y", "@wecandeo/mcp-videopack-v4"],
      "env": {
        "WECANDEO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code 설정

~/.claude.json (글로벌) 또는 프로젝트 .mcp.json:

{
  "mcpServers": {
    "wecandeo-v4": {
      "command": "npx",
      "args": ["@wecandeo/mcp-videopack-v4"],
      "env": {
        "WECANDEO_API_KEY": "your_api_key_here"
      }
    }
  }
}

소스에서 직접 실행

npm install && npm run build
WECANDEO_API_KEY=your_key node dist/index.js

Related MCP server: Sora2 MCP

파일 업로드 (로컬 파일 + URL 지원)

wecandeo_upload_video, wecandeo_upload_thumbnail, wecandeo_upload_caption 의 source 인자는 로컬 파일 경로(예: /Users/me/clip.mp4, ./caption.vtt)와 원격 URL(http(s)://...)을 모두 지원합니다. 로컬 경로인 경우 파일을 직접 읽어 업로드하고, URL인 경우 다운로드 후 업로드합니다.

업로드 흐름:

1. wecandeo_upload_create_token 으로 토큰과 업로드 URL들을 발급받습니다. (토큰 1개당 파일 1개)

2. wecandeo_upload_video 로 동영상을 업로드합니다.

3. wecandeo_upload_video_status / wecandeo_upload_video_progress 로 진행 상태를 확인합니다.

4. (선택) wecandeo_upload_thumbnail, wecandeo_upload_caption 으로 썸네일/자막을 추가합니다.

제공 도구

API 호스트 참고

• 레거시 엔드포인트: https://api.wecandeo.com (인증: key 쿼리 파라미터)

• v4 네이티브 엔드포인트: https://api.v4.wecandeo.com (인증: x-api-key 헤더) — wecandeo_video_details_v4, wecandeo_archive_original_download_url