VideoSeek

★ 2

from kennyzheng-builds

Find anything in any video. Semantic video search, video Q&A, persistent memory, and social media import (TikTok/YouTube/Instagram) for AI agents. 18 MCP tools.

🔥🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup

#social-media #git #video-editing

videoseek-mcp

Find anything in any video. Semantic video search, video Q&A, persistent memory, and social media import — all as MCP tools for your AI agent.

What can it do?

Give your AI agent (Claude, Cursor, Windsurf, etc.) the ability to:

Search videos by meaning — "find the moment where someone opens the gift" across your entire library
Ask questions about videos — multi-turn conversations with one video or your whole collection
Remember everything — persistent text + video memory that never forgets (Memory Augmented Generation)
Import from social media — pull and index content from TikTok, YouTube, Instagram, and 15+ platforms
Analyze on-the-fly — describe any video or image from URL without uploading
Transcribe — get visual scene descriptions or spoken word transcripts

Tools (18)

Video Management

Tool	What it does
`upload_video`	Upload and index a video from URL
`list_videos`	List all indexed videos
`get_video_status`	Check processing status
`delete_videos`	Remove videos from your library
`get_transcription`	Get visual or audio transcription

Search

Tool	What it does
`search_videos`	Semantic search across your private video library
`search_public`	Search TikTok, YouTube, Instagram by meaning
`search_audio`	Find when something was said in a video

Video Q&A

Tool	What it does
`chat_with_video`	Ask questions about specific videos (multi-turn)
`chat_personal`	Ask questions across your entire library + memories

Persistent Memory

Tool	What it does
`add_memory`	Store text with semantic indexing
`search_memories`	Find relevant memories by meaning
`list_memories`	List all stored memories

Vision Analysis

Tool	What it does
`caption_video`	Analyze a video from URL (no upload needed)
`caption_image`	Analyze an image from URL

Social Media Import

Tool	What it does
`import_from_url`	Import from any social media URL
`import_by_hashtag`	Import by hashtag from TikTok/YouTube/Instagram
`import_by_creator`	Import from a creator's profile

Resources & Prompts

Resources: memories://videos (your library), memories://memories (your stored knowledge)

Prompt templates: analyze-video, social-media-research, build-knowledge-base

Example Conversations

"Find a moment"

You: Find all moments where someone is cooking pasta

Agent uses search_videos → returns timestamped video segments

"Understand a video"

You: What's happening in this video? [URL]

Agent uses caption_video → instant analysis without uploading

"Research TikTok"

You: Research AI trends on TikTok

Agent uses search_public → import_from_url → chat_personal for insights

"Build knowledge"

You: Summarize all my meeting recordings

Agent uses list_videos → get_transcription → add_memory for key takeaways

How It Compares

Feature	videoseek-mcp	TwelveLabs MCP
Persistent memory (text + video)	Yes	No
Social media import (15+ platforms)	Yes	No
Memory Augmented Generation	Yes	No
Free tier	100 credits/month	10 hours
Multi-video Q&A	Yes	Yes
Semantic search	Yes	Yes

Environment Variables

Variable	Required	Default	Description
`MEMORIES_API_KEY`	Yes	—	API key from memories.ai
`MEMORIES_UNIQUE_ID`	No	`"default"`	Namespace for multi-tenant isolation

Development

npm install --include=dev
npm run build          # compile TypeScript
npm run dev            # watch mode
npx @modelcontextprotocol/inspector node build/index.js   # test interactively

Architecture

videoseek-mcp/
├── src/
│   ├── index.ts     # MCP server — 18 tools, 2 resources, 3 prompts
│   └── client.ts    # Video understanding API client
├── build/           # Compiled JS (generated)
├── package.json
└── tsconfig.json

TypeScript + Zod schemas + stdio transport. No dependencies beyond MCP SDK.

License

MIT

Copy & paste — that's it

git clone https://github.com/kennyzheng-builds/videoseek-mcp.git
cd videoseek-mcp
npm install --include=dev
npm run build

Before it works, you'll need: MEMORIES_API_KEY

Quick Start

1. Get an API Key

2. Install

git clone https://github.com/kennyzheng-builds/videoseek-mcp.git
cd videoseek-mcp
npm install --include=dev
npm run build

3. Connect to your AI client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "videoseek": {
      "command": "node",
      "args": ["/path/to/videoseek-mcp/build/index.js"],
      "env": {
        "MEMORIES_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "videoseek": {
      "command": "node",
      "args": ["/path/to/videoseek-mcp/build/index.js"],
      "env": {
        "MEMORIES_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

export MEMORIES_API_KEY="your-api-key"
claude mcp add videoseek -- node /path/to/videoseek-mcp/build/index.js