Videoseek

videoseek-mcp

在任意视频中查找任何内容。 语义视频搜索、视频问答、持久记忆和社交媒体导入，全部作为 MCP 工具提供给你的 AI Agent。

它能做什么？

让你的 AI Agent（Claude、Cursor、Windsurf 等）能够：

• 按含义搜索视频——在整个视频库中查找“有人打开礼物的片段”
• 询问视频相关问题——与单个视频或整个收藏进行多轮对话
• 记住一切——持久的文本与视频记忆，永不遗忘（记忆增强生成）
• 从社交媒体导入——从 TikTok、YouTube、Instagram 和 15 个以上的平台抓取并索引内容
• 即时分析——无需上传，即可通过 URL 描述任意视频或图像
• 转录——获取视觉场景描述或语音转录文本

快速开始

1. 获取 API 密钥

在 memories.ai 注册，并从 API 密钥页面 获取密钥。免费套餐每月包含 100 个额度。

2. 安装

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

3. 连接到你的 AI 客户端

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %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

添加到 .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

工具（18 个）

视频管理

工具	功能
upload_video	从 URL 上传并索引视频
list_videos	列出所有已索引的视频
get_video_status	查看处理状态
delete_videos	从视频库中删除视频
get_transcription	获取视觉或音频转录文本

搜索

工具	功能
search_videos	在私人视频库中进行语义搜索
search_public	按含义搜索 TikTok、YouTube、Instagram
search_audio	查找视频中说出某句话的时间点

视频问答

工具	功能
chat_with_video	询问特定视频相关问题（多轮对话）
chat_personal	跨整个视频库和记忆提问

持久记忆

工具	功能
add_memory	存储文本并进行语义索引
search_memories	按含义查找相关记忆
list_memories	列出所有已存储的记忆

视觉分析

工具	功能
caption_video	通过 URL 分析视频（无需上传）
caption_image	通过 URL 分析图像

社交媒体导入

工具	功能
import_from_url	从任意社交媒体 URL 导入
import_by_hashtag	按话题标签从 TikTok/YouTube/Instagram 导入
import_by_creator	从创作者主页导入

资源与提示词

资源： memories://videos（你的视频库）、memories://memories（你存储的知识）

提示词模板： analyze-video、social-media-research、build-knowledge-base

对话示例

“查找某个片段”

你：找出所有有人在煮意大利面的片段

Agent 使用 search_videos → 返回带时间戳的视频片段

“了解视频内容”

你：这个视频里发生了什么？[URL]

Agent 使用 caption_video → 无需上传即可即时分析

“研究 TikTok”

你：研究 TikTok 上的 AI 趋势

Agent 使用 search_public → import_from_url → chat_personal 获取洞见

“构建知识”

你：总结我所有的会议录音

Agent 使用 list_videos → get_transcription → add_memory 记录要点

对比

功能	videoseek-mcp	TwelveLabs MCP
持久化记忆（文本 + 视频）	是	否
社交媒体导入（15 个以上平台）	是	否
记忆增强生成	是	否
免费套餐	每月 100 个点数	10 小时
多视频问答	是	是
语义搜索	是	是

环境变量

变量	必需	默认值	描述
MEMORIES_API_KEY	是	—	来自 memories.ai 的 API 密钥
MEMORIES_UNIQUE_ID	否	"default"	用于多租户隔离的命名空间

开发

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

架构

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 模式 + stdio 传输。除 MCP SDK 外无其他依赖。

许可证

MIT