JinDaGe - twelvelabs-mcp-server MCP Details

article

README

🚀 TwelveLabs MCP 服务器

TwelveLabs MCP 服务器是基于 TwelveLabs API 的模型上下文协议（Model Context Protocol, MCP）服务器，能够实现索引管理、视频分析与搜索等功能。

✨ 主要特性

索引创建及管理
视频上传与分析
基于文本的视频搜索
视频转录生成（包括字幕、摘要等）

📦 安装指南

先决条件

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 中遇到卷问题，请手动创建卷并将其连接到服务：

创建卷：

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

📚 详细文档

故障排除

模块未找到错误

此错误通常发生在卷挂载设置不正确时。请参考上述“Portainer 环境下运行的注意事项”。

API 密钥身份验证错误

请检查环境变量 TWELVELABS_API_KEY 是否已正确设置。

📄 许可证

MIT

twelvelabs-mcp-server