HT

hrishikesh332/tl_indexing_mcp

Developer tools
67 stars 1 forks Quality 49 Trend 31

This MCP server provides two tools for video indexing with TwelveLabs:

Overview

This MCP server provides two tools for video indexing with TwelveLabs: Upload and index a local video file for search and analysis. - index_id (required): The ID of the TwelveLabs index to add the video to - video_file_path (required): Absolute path to the local video file (e.g., /path/to/video.mp4) Check the current status of a video indexing task. - task_id (required): The ID of the indexing task from start_video_indexing - Status (pending, processing, ready, or failed) - Video ID when ready - Metadata and error details if applicable

README

Setup for the TwelveLabs Indexing for the Local Video

After navigative to the file -

1. Build with TypeScript

npx tsc --outDir build --module NodeNext --target ES2022

2. Verify build

ls -la build/index.js

Available Tools

This MCP server provides two tools for video indexing with TwelveLabs:

1. start_video_indexing

Upload and index a local video file for search and analysis.

Parameters:

  • index_id (required): The ID of the TwelveLabs index to add the video to
  • video_file_path (required): Absolute path to the local video file (e.g., /path/to/video.mp4)

Returns: Task ID and indexing status

2. get_indexing_task_status

Check the current status of a video indexing task.

Parameters:

  • task_id (required): The ID of the indexing task from start_video_indexing

Returns:

  • Status (pending, processing, ready, or failed)
  • Video ID when ready
  • Metadata and error details if applicable

Configuration

Edit the config on the client side -

{
  "mcpServers": {
    "twelvelabs-indexing": {
      "command": "node",
      "args": ["/Users/hrishikesh/Desktop/tl-index-mcp/twelvelabs-indexing/build/index.js"],
      "env": {
        "TWELVELABS_API_KEY": "Your TL API KEY"
      }
    }
  }
}
View this README on GitHub

Install

npx tsc --outDir build --module NodeNext --target ES2022