Librarian:知识库管家
把你的 Obsidian 库变成可搜索、可漫游的知识图谱,让 Claude 自动建立双向链接并沉淀每一次工作中学到的知识。
证据显示核心 MCP 服务器声称纯本地运行、无遥测,写操作仅在用户明确要求时进行,链接建议需用户确认;from claude 明确提示会话转录可能含密钥并要求不得复制凭据,属正面。扣分项:from gmail/calendar/web/twitter 依赖外部连接器读取邮件、日历、网页内容并写入 vault,数据流披露较浅,缺少最小权限与失败回滚说明;daydream 会生成大量自动写入;外部导入内容未经用户逐条审查即入库,确认机制不完整。
SKILL.md 各命令步骤自洽、输出示例清晰、有失败分支(找不到文件则停止、连接器失败则回退或询问用户)。但静态审阅无法执行验证;仓库未见针对 skill 关键路径的测试;且提供的 skill/SKILL.md 文本在 status 命令处截断,说明文档不完整,无法核实全部 12 条命令。
目标用户和场景明确(Obsidian/markdown vault 用户,12 条命令边界清晰),非适用范围有部分说明。扣分:核心 from 子命令完全依赖 Gmail、Google Calendar、Exa、Tavily 等在中国大陆不可达或受限的海外服务,未声明此局限,未提供中文语言环境适配;触发条件依赖 slash 命令而非语义描述,语义触发精度证据有限。
MIT 许可证、作者、版本号、仓库地址齐备,安装说明详尽(Homebrew/二进制/源码),README 分层清晰、有对比表和示例 vault。扣分:SKILL.md 本身在 status 一节截断,含隐藏假设(如 ce:compound、session-close、bird CLI 等未在本仓库内定义的外部依赖);无 CHANGELOG,维护责任与更新路径依赖单一未验证发布者。
宣称的核心能力(trigram 搜索、自动 wikilink、图遍历、社区检测)与 17 个工具描述对应,命令产出格式具体、示例可直接使用,相对手工操作有明确增量价值。扣分:静态审阅无法验证产出正确性;对比表中自评数据未经第三方验证;daydream 成本估算无依据材料。
有可审计的一手材料:源码依赖清单、release CI 工作流、示例 vault 说明。但仓库内未见提交的测试套件覆盖 skill 关键路径,skill 声明的行为无法在静态审阅中独立复现,多来源交叉验证有限,故不高于 5。
- from gmail/from calendar 会把邮件和日历内容(含参与者邮箱)写入 vault 明文文件,请确认 vault 的存储与同步安全性。
- from web/from twitter/from gmail 依赖 Exa、Tavily、Gmail、Google Calendar 等海外服务,在中国大陆网络环境下可能完全不可用。
- skill/SKILL.md 文本在 status 一节截断,文档不完整,使用前请核对仓库完整文件。
- from claude 读取 ~/.claude/projects/ 下的完整会话转录;虽提示不复制凭据,仍建议在含敏感信息的会话上谨慎使用。
- daydream 会并行启动多个子代理并批量写入文件,成本约 $0.40-0.50/次,请先小规模验证。
- 发布者未经 FollowSkills 企业注册库验证,身份未知;无 CHANGELOG,更新路径不明确。
这个 Skill 能做什么,适合哪些场景?
Librarian 是一个用 Rust 编写的本地 MCP 服务器,把 Karpathy 提出的 LLM Wiki 模式产品化。它直接读写本地 Markdown 文件(不需要 Obsidian 在运行),提供三元组索引全文搜索、写入时自动补 wikilink、双向图谱遍历、Louvain 社区检测和 D3 交互式可视化。配套的 /librarian 技能把这些底层工具封装成 12 个斜杠命令,覆盖文档摄取、多来源导入(网页、Gmail、Twitter、日历、Claude 会话)、图谱分析和跨笔记洞见发现。数据完全留在本机,通过 stdio 与 Claude 通信,无网络调用和遥测。
安装后向 Claude 暴露 17 个 MCP 工具:library_search(三元组索引全文搜索)、library_write(写入时扫描已有笔记标题并自动包裹 [[wikilink]],跳过代码块/URL/已有链接,支持 frontmatter 别名)、library_traverse 与 library_shortest_path(BFS 遍历与最短路径)、library_cluster(Louvain 社区检测)、library_visualize(生成自包含的 D3 交互式 HTML)、library_report(输出神节点、社区、跨社区桥接连接的 GRAPH_REPORT.md)等。/librarian 技能在此之上提供命令:ingest 把 docs/solutions/ 下的方案文档导入库并自动链接;import 借助 MarkItDown 把 PDF/DOCX/图片/音频等转成 Markdown;from web/gmail/twitter/calendar/claude 通过对应连接器把外部内容导入为结构化笔记;daily 追加当日学习到日记;daydream 用并行子代理随机配对笔记寻找非显然联系(约每轮 0.40-0.50 美元)。
- 用 Obsidian 管理长期知识库的研究者,希望 Claude 写入的笔记自动接进图谱,而不是产生孤立文件
- 用 Claude Code 写代码的工程师,想把 docs/solutions/ 里沉淀的排错方案跨项目检索复用(与 /ce:compound 工作流配合)
- 做文献或话题调研的分析师,想用 analyze 和 graph 查看主题聚类、神节点和笔记之间的最短关联路径
- 需要把零散素材归档的知识工作者:把 PDF 报告、Gmail 讨论串、Twitter 长推、会议日程一键转成带 frontmatter 和摘要的库内笔记
- 想主动发现跨领域灵感的写作者,用 daydream 让子代理配对随机笔记并经新颖性/连贯性/有用性三维评分筛选
这个 Skill 有哪些优点和局限?
- 完全本地运行:数据不出本机,无网络调用、无遥测,README 明确声明
- 写入即自动建链,且跳过代码块、URL 和已有链接,避免破坏内容;支持 frontmatter 别名
- 与 Obsidian 完全兼容且可同时打开,读写标准 wikilink 和 Journal/YYYY/ 日期约定
- 图谱能力超出同类:Louvain 社区检测、PageRank/介数中心性的神节点排名、D3 交互可视化
- 独立 Rust 二进制,Obsidian 无需运行;支持 .librarianignore 自定义排除
- 部分命令依赖外部工具:import 需要 MarkItDown(Python),from twitter 需要 bird CLI,缺失时命令会中止
- from gmail / from calendar 依赖 Claude.ai 的 Gmail 和 Google Calendar MCP 连接器,非 Claude.ai 环境不可用
- daydream 每轮约 0.40-0.50 美元的 API 成本,且使用并行子代理,依赖特定模型分级(Sonnet/Haiku)
- 未见公开测试套件或基准数据;Windows 下多库环境变量 LIBRARIAN_VAULTS 标注仅限 Unix
- 搜索索引在启动时构建于内存,10,000+ 文件场景下的资源占用未给出数据
如何安装这个 Skill?
1) 安装二进制:brew install ngmeyer/tap/librarian-mcp,或从 GitHub Releases 下载(macOS/Linux x86_64+arm64、Windows),或 cargo install --git https://github.com/ngmeyer/librarian-mcp。2) 运行 librarian-mcp --setup ~/my-vault,它会自动写入 Claude Desktop 和 Claude Code 的 MCP 配置(会备份原配置)并安装 /librarian 技能。3) 重启 Claude。多库可用 --setup 后跟多个路径,或设 LIBRARIAN_VAULT / LIBRARIAN_VAULTS 环境变量,也可手动在 MCP 配置中添加 command/args。import 功能另需 pip install markitdown;from twitter 需要 bird CLI。
如何使用这个 Skill?
重启 Claude 后直接使用斜杠命令,例如:/librarian analyze 生成完整图谱报告与 GRAPH_VIZ.html 可视化;/librarian search "HMR timeout" 跨库深搜并综合结果;/librarian ingest 导入最近的方案文档(ingest all 批量);/librarian from web <url> 把网页转成库内笔记;/librarian from claude 从本地 ~/.claude/projects/ 下的 JSONL 会话记录提取决策与方案归档;/librarian daily "今天学到 X" 追加日记。不带参数运行会显示全部 12 个命令的用法。
这个 Skill 与同类方案有什么区别?
README 的对比表列出了三种替代方案:直接读文件(无搜索/链接/图谱能力)、Obsidian Copilot 和 mcp-obsidian(均为插件形态,依赖 Obsidian 运行,缺少自动建链、社区检测和独立可视化)。Librarian 的差异化在于独立二进制、写入自动建链和完整的图谱分析管线。