Videoseek

videoseek-mcp

あらゆる動画から何でも見つけられます。 セマンティック動画検索、動画への質問、永続的なメモリ、ソーシャルメディアからのインポートを、AI エージェント向けの MCP ツールとして提供します。

何ができますか？

AI エージェント（Claude、Cursor、Windsurf など）に、次の機能を追加できます。

• 意味で動画を検索 — ライブラリ全体から「誰かがプレゼントを開ける場面を見つけて」
• 動画について質問 — 1 本の動画、またはコレクション全体を対象にした複数ターンの会話
• すべてを記憶 — 決して忘れない、永続的なテキストと動画のメモリ（Memory Augmented Generation）
• ソーシャルメディアからインポート — TikTok、YouTube、Instagram など 15 以上のプラットフォームからコンテンツを取得してインデックス化
• その場で分析 — アップロードせずに、URL から任意の動画や画像を説明
• 文字起こし — 映像シーンの説明、または音声の文字起こしを取得

クイックスタート

1. API キーを取得する

こちらでサインアップし、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

会話例

「場面を見つける」

あなた：誰かがパスタを料理している場面をすべて見つけて

エージェントが search_videos を使用 → タイムスタンプ付きの動画セグメントを返します

「動画を理解する」

あなた：この動画では何が起きていますか？ [URL]

エージェントが caption_video を使用 → アップロードせずにすぐに分析します

「TikTok を調査する」

あなた：TikTok の AI トレンドを調査して

エージェントが search_public → import_from_url → chat_personal を使用して知見を得ます

「ナレッジを構築する」

あなた：会議の録画をすべて要約して

エージェントが list_videos → get_transcription → add_memory を使用して重要なポイントを保存します

比較

機能	videoseek-mcp	TwelveLabs MCP
永続メモリ（テキスト＋動画）	あり	なし
ソーシャルメディアからのインポート（15以上のプラットフォーム）	あり	なし
メモリ拡張生成	あり	なし
無料プラン	月100クレジット	10時間
複数動画のQ&A	あり	あり
セマンティック検索	あり	あり

環境変数

変数	必須	デフォルト	説明
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