TwelveLabs MCP 服务器

这是一个利用 TwelveLabs API 的模型上下文协议 (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