Twelvelabs MCP Server

🚀 TwelveLabs 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