TwelveLabs MCP 서버

TwelveLabs MCP 서버

site icon
2025.04.05 0
JavaScript비디오 분석텍스트 생성内容生成
TwelveLabs MCP 서버는 TwelveLabs API를 활용한 Model Context Protocol(MCP) 서버입니다. 주요 기능으로는 인덱스 생성 및 관리, 비디오 업로드 및 분석, 텍스트 기반 비디오 검색, 비디오로부터 텍스트 생성 (트랜스크립트, 요약 등)이 있습니다. 이 서버는 비디오 콘텐츠를 분석하고 텍스트로 변환하는 데 사용되며, 개발자들이 비디오 데이터를 쉽게 관리하고 검색할 수 있도록 도와줍니다.
View on GitHub

Overview

基本能力

产品定位

TwelveLabs MCP 서버는 비디오 콘텐츠를 분석하고 텍스트로 변환하는 데 사용되는 서버입니다. 개발자들이 비디오 데이터를 쉽게 관리하고 검색할 수 있도록 도와줍니다.

核心功能

  • 인덱스 생성 및 관리
  • 비디오 업로드 및 분석
  • 텍스트 기반 비디오 검색
  • 비디오로부터 텍스트 생성 (트랜스크립트, 요약 등)

适用场景

  • 비디오 콘텐츠 분석
  • 비디오 데이터 검색
  • 비디오 트랜스크립트 생성
  • 비디오 요약 생성

工具列表

  • Docker 및 Docker Compose: 컨테이너화된 실행을 위한 도구
  • Node.js: 로컬 실행 시 필요한 런타임 환경

常见问题解答

모듈을 찾을 수 없는 오류

이 오류는 보통 볼륨 마운트가 올바르게 설정되지 않았을 때 발생합니다. "Portainer에서 실행 시 주의사항"을 참고하세요.

API 키 인증 오류

환경 변수 TWELVELABS_API_KEY가 올바르게 설정되었는지 확인하세요.

使用教程

使用依赖

  • TwelveLabs API 키
  • Docker 및 Docker Compose (선택사항, 컨테이너화된 실행을 위해)
  • Node.js (로컬 실행 시)

安装教程

로컬에서 실행하기

  1. 필요한 환경 변수 설정:
export TWELVELABS_API_KEY="your_api_key_here"
  1. 종속성 설치:
npm install
  1. 서버 실행:
npm start

Docker를 사용하여 실행하기

방법 1: Docker Compose 사용
  1. 필요한 폴더 생성:
mkdir -p data
  1. 환경 변수 설정:
export TWELVELABS_API_KEY="your_api_key_here"
  1. Docker Compose로 실행:
docker-compose up -d
방법 2: Docker 명령어 직접 사용
docker build -t twelvelabs-mcp .
docker run -e TWELVELABS_API_KEY="your_api_key_here" twelvelabs-mcp

调试方式

Portainer에서 실행 시 주의사항

Portainer에서 볼륨 문제가 발생할 경우, 다음과 같이 수동으로 볼륨을 생성하고 서비스에 연결해 보세요: 1. 볼륨 생성:

docker volume create \
  --driver local \
  --opt type=none \
  --opt device=/path/to/host/directory \
  --opt o=bind \
  twelvelabs-mcp-data
  1. 서비스 업데이트 (N8N 환경에서):
docker service update \
  --mount-add type=volume,source=twelvelabs-mcp-data,target=/app/data \
  your_service_name

许可证

该项目遵循 MIT 开源许可条款。