Skip to main content
Glama
@wecandeo/mcp-videopack-v4

@wecandeo/mcp-videopack-v4

Official
by wecandeo

Wecandeo VideoPack v4 MCP Server

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

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

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

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

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

설치 및 실행

환경 변수

변수

설명

WECANDEO_API_KEY

Wecandeo 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: ken-api-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 으로 썸네일/자막을 추가합니다.

제공 도구

그룹

도구

설명

Upload

wecandeo_upload_create_token

업로드 토큰 발급 (V4)

wecandeo_upload_video

동영상 업로드 (로컬 파일/URL)

wecandeo_upload_video_status

업로드 상태 조회

wecandeo_upload_video_progress

업로드 진행률 조회

wecandeo_video_encoding_status

인코딩 상태 조회

wecandeo_upload_thumbnail

썸네일 업로드 (로컬 파일/URL)

wecandeo_upload_caption

자막(WebVTT) 업로드 (로컬 파일/URL)

wecandeo_upload_caption_language

자막 언어 코드 목록

Video Retrieve

wecandeo_video_list_package

패키지별 동영상 목록

wecandeo_video_list_folder

폴더별 동영상 목록

wecandeo_video_details

동영상 상세 (legacy)

wecandeo_video_details_v4

동영상 상세 (v4, AI 요약 포함)

wecandeo_video_pub_code

배포 코드 조회

wecandeo_video_encoded_file

인코딩 파일 목록

wecandeo_video_onetime_key

원타임 키 발급

wecandeo_video_thumbnail

썸네일 이미지 조회

wecandeo_video_caption

자막 파일 조회

Video Update

wecandeo_video_add_to_package

패키지에 추가

wecandeo_video_exclude_from_package

패키지에서 제외

wecandeo_video_start_publish

배포 시작

wecandeo_video_pause_publish

배포 중지

wecandeo_video_modify_folder

보관함 폴더 이동

wecandeo_video_modify_meta

메타데이터 수정

wecandeo_video_set_default_thumbnail

대표 썸네일 설정

Package

wecandeo_package_list

배포 패키지 목록

Archive

wecandeo_archive_create_folder

동영상 폴더 생성

wecandeo_archive_list_folders

동영상 폴더 목록

wecandeo_archive_folder_by_name

폴더명으로 조회

wecandeo_archive_original_download_url

원본 다운로드 URL 조회

(공통)

ping

서버 응답 확인

API 호스트 참고

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

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

Available Tools

29 tools
pingA

Check if the Wecandeo VideoPack v4 MCP server is responsive

Inputs: no named parameters.

wecandeo_archive_create_folderA

Create a new video folder in the media archive. Returns the new folder ID.

Inputs: folderName (required).

wecandeo_archive_folder_by_nameC

Look up a media-archive video folder by its name.

Inputs: folderName (required).

wecandeo_archive_list_foldersB

Retrieve the list of video folders in the media archive.

Inputs: no named parameters.

wecandeo_archive_original_download_urlA

Get the download URL of the original video in the media archive. The URL is valid for 2 days.

Inputs: accessKey (required).

wecandeo_package_listA

Retrieve the list of distribution packages (packageId, packageType, packageName, sharing flags).

Inputs: no named parameters.

wecandeo_upload_captionA

Upload a WebVTT (.vtt) caption file for a video. Issues a caption upload token for the accessKey then uploads. source can be a local file path or a remote URL.

Inputs: source (required), accessKey (required), langId, captionType.

wecandeo_upload_caption_languageA

Retrieve the list of supported caption languages and their langId codes.

Inputs: no named parameters.

wecandeo_upload_create_tokenA

Create a V4 video upload token. Returns { ver, uploadUrl, token }. A token uploads exactly one file and is valid for 60 minutes.

Inputs: no named parameters.

wecandeo_upload_thumbnailA

Upload a thumbnail image for a video. Issues a thumbnail upload token for the accessKey then uploads. source can be a local file path or a remote URL.

Inputs: source (required), accessKey (required).

wecandeo_upload_videoB

Upload a video file using a V4 upload token. source can be a local filesystem path or a remote http(s) URL.

Inputs: token (required), source (required), folderId (required), uploadUrl (required), +13 more.

wecandeo_upload_video_progressA

Check the upload progress of a video by token. Returns process (0-100%) and transferred byte counters.

Inputs: token (required).

wecandeo_upload_video_statusA

Check the upload status of a video by token. Returns a status such as UPLOADING, UPLOADED, THUMBS, DEPLOY, COMPLETE, U_ERROR, FILEOVER.

Inputs: token (required).

wecandeo_video_add_to_packageB

Add a video to a distribution package (triggers encoding / URL issuance).

Inputs: accessKey (required), packageId (required).

wecandeo_video_captionB

Retrieve the caption files of a video.

Inputs: accessKey (required).

wecandeo_video_detailsB

Get detailed information of a video. Returns camelCase fields and AI summaries when available.

Inputs: accessKey (required), packageId (required).

wecandeo_video_encoded_fileB

Retrieve the list of encoded files (profiles) for a video.

Inputs: accessKey (required), packageId (required).

wecandeo_video_encoding_statusB

Check the encoding status of an uploaded video. Returns per-profile process (0-100) and status.

Inputs: accessKey (required), packageId (required).

wecandeo_video_exclude_from_packageB

Exclude a video from a distribution package.

Inputs: accessKey (required), packageId (required).

wecandeo_video_list_folderC

Retrieve the list of videos in a media-archive folder. Supports search, sort and pagination.

Inputs: folderId (required), page, keyword, pageSize, +3 more.

wecandeo_video_list_packageB

Retrieve the list of videos in a distribution package. Supports search, sort and pagination.

Inputs: packageId (required), page, keyword, folderId, +4 more.

wecandeo_video_modify_folderB

Move a video to a different media-archive folder.

Inputs: folderId (required), accessKey (required).

wecandeo_video_modify_metaC

Modify the metadata (title, series, author, copyright, rate, content, etc, tag) of a video.

Inputs: accessKey (required), etc, tag, rate, +5 more.

wecandeo_video_onetime_keyA

Generate a time-limited one-time access key for a video key (Level 2) or file key (Level 3).

Inputs: key (required), expire.

wecandeo_video_pause_publishB

Pause publishing (distributing) a video within a package.

Inputs: accessKey (required), packageId (required).

wecandeo_video_pub_codeB

Get the distribution codes (video URL, play URL, per-file URLs) of a video in a package.

Inputs: accessKey (required), packageId (required).

wecandeo_video_set_default_thumbnailB

Set a specific extracted thumbnail (by sequence) as the video's default thumbnail.

Inputs: seq (required), accessKey (required).

wecandeo_video_start_publishC

Start publishing (distributing) a video within a package.

Inputs: accessKey (required), packageId (required).

wecandeo_video_thumbnailA

Retrieve the thumbnail images (extracted frames, multiple sizes) of a video.

Inputs: accessKey (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 29 tools

    Disambiguation5/5

    Each tool targets a distinct action and resource (upload, status, progress, captions, thumbnails, distribution, archive). Even similar tools like upload_video_status and upload_video_progress are clearly differentiated by their return values.

    Naming Consistency5/5

    All tools follow the consistent pattern 'wecandeo_verb_noun' (e.g., wecandeo_upload_create_token, wecandeo_video_details). The only exception is 'ping', but it is a standard health check tool.

    Tool Count4/5

    29 tools is above the typical well-scoped range but justified given the breadth of video management features (upload, encoding, captions, distribution, archive). A few tools could potentially be combined (e.g., status and progress) but overall the count is reasonable.

    Completeness3/5

    The toolset covers core workflows (upload, encode, distribute, metadata) but lacks delete operations for videos, captions, and thumbnails. This is a notable gap that could cause dead ends during agent-driven tasks.

    Related MCP Connectors

    Related MCP Servers