
TwelveLabs MCP 서버

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 (로컬 실행 시)
安装教程
로컬에서 실행하기
- 필요한 환경 변수 설정:
export TWELVELABS_API_KEY="your_api_key_here"
- 종속성 설치:
npm install
- 서버 실행:
npm start
Docker를 사용하여 실행하기
방법 1: Docker Compose 사용
- 필요한 폴더 생성:
mkdir -p data
- 환경 변수 설정:
export TWELVELABS_API_KEY="your_api_key_here"
- 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
- 서비스 업데이트 (N8N 환경에서):
docker service update \
--mount-add type=volume,source=twelvelabs-mcp-data,target=/app/data \
your_service_name