🚀 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