Archivarix Tube Search

tube-search-mcp

适用于 Archivarix Tube Search 的 MCP 服务 — 通过 AI 助手搜索已存档的 YouTube 视频。

搜索自 2005 年以来已编入索引的 10 亿多个 YouTube 视频。查找已删除的视频、元数据、缩略图和字幕。

快速开始

npx tube-search-mcp --api-key tsk_YOUR_KEY

或者使用环境变量：

export TUBE_API_KEY=tsk_YOUR_KEY
npx tube-search-mcp

在 tube.archivarix.net 获取 API 密钥（Profile → API Keys）。

配置

Claude Desktop

添加到 ~/.claude/claude_desktop_config.json：

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

Claude Code

添加到 ~/.claude/mcp.json：

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

VS Code

在项目中的 .vscode/mcp.json 添加：

{
  "servers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

可用工具

工具	描述
search_channel	查找 YouTube 频道中所有已存档的视频
search_videos	对视频标题和描述进行全文搜索
get_video	根据 ID 获取特定视频的元数据
get_subtitles	获取易读的纯文本字幕
get_summary	获取 AI 生成的视频摘要
generate_summary	为视频生成新的 AI 摘要
browse_summaries	按标签、频道或语言浏览摘要
get_video_status_history	查看视频的状态变更历史
get_usage	查看当前 API 用量和限额

资源

URI	描述
tube://video/{videoId}	视频元数据
tube://channel/{channelId}	频道信息
tube://subtitles/{videoId}	纯文本字幕
tube://summary/{videoId}	AI 生成的摘要
tube://tags	热门摘要标签

提示词

提示词	描述
research_video	全面的视频分析工作流
channel_overview	频道研究和统计信息
find_deleted	发现并分析已删除的视频

环境变量

变量	描述	默认值
TUBE_API_KEY	API 密钥（必需）	—
TUBE_MCP_URL	自定义 MCP 端点	https://tube.archivarix.net/mcp

工作原理

此软件包充当 stdio 到 HTTP 的代理。它通过 Streamable HTTP 连接到远程 Archivarix Tube Search MCP 服务，并通过 stdio 传输向本地 AI 客户端提供相同的工具、资源和提示词。

AI Client ←(stdio)→ tube-search-mcp ←(HTTP)→ tube.archivarix.net/mcp

文档

完整文档：tube.archivarix.net/guide/mcp

许可证

MIT