Twelvelabs MCP Server

🚀 十二實驗室MCP服務器

本項目是基於十二實驗室（TwelveLabs）API的模型上下文協議（Model Context Protocol, MCP）服務器，為用戶提供視頻索引、搜索、轉錄等功能。

🚀 快速開始

先決條件

• 十二實驗室（TwelveLabs）API密鑰
• Docker 及 Docker Compose（可選，用於容器化運行）
• Node.js（本地運行時需要）

✨ 主要特性

• 索引創建及管理
• 視頻上傳與分析
• 基於文本的視頻搜索
• 視頻轉錄生成（包括字幕、摘要等）

📦 安裝指南

本地運行方法

1. 設置必要的環境變量：

export TWELVELABS_API_KEY="your_api_key_here"

2. 安裝依賴項：

npm install

3. 啟動服務器：

npm start

使用 Docker 運行

方法 1：使用 Docker Compose

1. 創建所需的文件夾：

mkdir -p data

2. 設置環境變量：

export TWELVELABS_API_KEY="your_api_key_here"

3. 使用 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

2. 更新服務（在 N8N 環境中）：

docker service update \
  --mount-add type=volume,source=twelvelabs-mcp-data,target=/app/data \
  your_service_name

🔧 技術細節

故障排除

模塊未找到錯誤

此錯誤通常發生在卷掛載設置不正確時。請參考上述“Portainer 環境下運行的注意事項”。

API 密鑰身份驗證錯誤

請檢查環境變量 TWELVELABS_API_KEY 是否已正確設置。

📄 許可證

本項目採用 MIT 許可證。