🚀 十二实验室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 许可证。