Video Reader

io.github.Kandecho由 GitHub 账号 Kandecho 发布v0.1.0更新于 Nov 4, 2026

Local video evidence, transcripts, frames, comments and shared reading queues/history.

概览

AI 生成的概览

本地 MCP 服务器,让 AI 助手阅读 B 站、YouTube 和本地视频:字幕、取样画面、评论以及待读队列与历史。

可以做什么
  • 读懂视频内容:获取字幕、语音与带时间点的取样画面,便于继续追问
  • 核对具体时刻:调出相关画面与讲解对照
  • 按主题搜索 B 站视频并预览分镜
  • 按需读取评论、回复和弹幕
  • 长视频可分次阅读,复用已取得的材料,并导出引用的画面与原话
  • 管理通用待读队列与历史,以及可选的 Scroll 个人工作流
适用场景
适合让助手整理或核对一条视频、回答与时间点相关的问题,或在多次会话间维护待读视频清单,无需先生成笔记。
运行要求
在 Windows x64 上本地运行,需要 PowerShell 7、Python 3.12、uv 以及 FFmpeg/ffprobe,读取 YouTube 还需 Node.js。通过随包脚本安装并接入助手。B 站使用组件自带的扫码登录,YouTube 可导入手动导出的短期 Cookie。无字幕视频需另行配置本地转写。
安装前请注意
涉及平台登录与 Cookie:B 站登录按组件独立进行,YouTube Cookie 需手动导入,应视为凭据妥善保管。可选的 Scroll 工作流可登录 B 站小号,收发授权私信并把转发视频加入队列。处理默认在本地进行,但交给助手的材料由所选宿主和模型处理;Gemini 云端读取默认关闭且不会自动切换。字幕与机器识别可能出错。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Video Reader,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Video Reader

把 Bilibili、YouTube 和本地视频交给你正在用的 AI 助手阅读:整理内容、核对画面,或带着时间点继续追问。

Video Reader 提供字幕、语音和画面材料,通过 MCP 接入 Codex、Claude Code 和 DSH;理解和回答由助手完成。你可以直接贴链接提问,不必先生成笔记。

开始使用 · 下载整包 · 文档

可以用来做什么

  • 读懂一条视频:“整理这条视频的主要观点和论据,标出值得回看的位置。”
  • 核对具体细节:“06:12 的图和讲解一致吗?把相关画面拿出来看。”
  • 接着讨论或保存:“继续上次没看完的部分,把引用的画面和原话一起导出。”

还可以按主题找 B 站视频、预览分镜,以及按需读取评论、回复和弹幕。长视频可以分次阅读,已取得的材料可继续使用。

整包还包含通用队列与历史、Scroll 个人工作流。Scroll 可给组件单独登录 B 站小号,使用小号首页推荐,与主号收发授权私信、接收转发视频并入队。这些能力已有真实使用;定时工作流等仍在试用,常驻收件和持续后台阅读尚未接入。详见能力状态。

开始使用

当前发布版面向 Windows x64、PowerShell 7 和 Python 3.12。安装需要 uv、FFmpeg / ffprobe;读取 YouTube 时还需要 Node.js。uv 可按需准备 Python。

下载并解压源码包,在解压后的目录打开 PowerShell 7,运行:

powershell
& './bootstrap.ps1'& './run.ps1' doctor

然后按 首次使用指南 接入你的助手,贴一个视频链接并说明你想了解什么。安装不会自动下载语音模型;没有可用字幕的视频,需要另行 配置本地转写。

先了解这些边界

  • 处理默认在本地进行。 Gemini 云端读取默认关闭,不会在失败后自动切换到云端。交给助手的材料由你选择的宿主和模型处理。
  • 字幕和机器识别可能出错。 重要细节可以回到原话、原图核对;取样画面不能保证覆盖每个短暂动作。
  • 平台访问需要相应权限。 B 站使用组件自己的扫码登录;YouTube 可导入你手动导出的短期 Cookie。登录和平台限制仍可能影响读取。

本版的已知限制和验证范围见 发布说明。

按需要查文档

你想做什么从这里开始
第一次安装、接入助手、读一条视频首次使用
在 DSH 中安装整包薄适配DSH 接入
从 DSH 插件索引发现本项目发现与收录 · 开放插件市场条目
使用 MCPB 接入包、在官方目录查询MCP Registry
区分可用能力、试用部分与未完成项能力状态
设置模型、登录或调整文件位置安装与配置
查命令、工具参数、续读和导出CLI 与 MCP 参考
管理待读视频、附言和结果队列与历史
使用个人推荐、私信收件和授权投递Scroll
报告问题或参与开发贡献与复现
了解开发顺序与阶段验收开发路线

Scroll 可按需使用,普通读片无需配置个人投递。文档首页列出完整入口;与 dsh-bili-scroll 等实现的不同侧重见相关项目。

许可

项目原创代码采用 MIT。第三方代码、依赖和模型保留各自许可,见 第三方声明。源码包不含用户视频、私信、凭据或模型。

来源:README.md,提交 4a9f981

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次,以列出其工具,但未能完成:该软件包类型无法在沙箱中运行。

版本历史

1
  1. v0.1.0最新Nov 4, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分