效率与协作 obsidianknowledge-graphmcp-serverwikilinkstrigram-searchcommunity-detectionnote-ingestion

Librarian:知识库管家

把你的 Obsidian 库变成可搜索、可漫游的知识图谱,让 Claude 自动建立双向链接并沉淀每一次工作中学到的知识。

FollowSkills 评估 · FSRS-2.0
谨慎使用
50/ 100 五分制 2.5 / 5
1 2 3 4 5 6
1信任安全14 / 25 · 2.8/5

证据显示核心 MCP 服务器声称纯本地运行、无遥测,写操作仅在用户明确要求时进行,链接建议需用户确认;from claude 明确提示会话转录可能含密钥并要求不得复制凭据,属正面。扣分项:from gmail/calendar/web/twitter 依赖外部连接器读取邮件、日历、网页内容并写入 vault,数据流披露较浅,缺少最小权限与失败回滚说明;daydream 会生成大量自动写入;外部导入内容未经用户逐条审查即入库,确认机制不完整。

2可靠稳定9 / 20 · 2.3/5

SKILL.md 各命令步骤自洽、输出示例清晰、有失败分支(找不到文件则停止、连接器失败则回退或询问用户)。但静态审阅无法执行验证;仓库未见针对 skill 关键路径的测试;且提供的 skill/SKILL.md 文本在 status 命令处截断,说明文档不完整,无法核实全部 12 条命令。

3适用触发7 / 15 · 2.3/5

目标用户和场景明确(Obsidian/markdown vault 用户,12 条命令边界清晰),非适用范围有部分说明。扣分:核心 from 子命令完全依赖 Gmail、Google Calendar、Exa、Tavily 等在中国大陆不可达或受限的海外服务,未声明此局限,未提供中文语言环境适配;触发条件依赖 slash 命令而非语义描述,语义触发精度证据有限。

4规范维护10 / 15 · 3.3/5

MIT 许可证、作者、版本号、仓库地址齐备,安装说明详尽(Homebrew/二进制/源码),README 分层清晰、有对比表和示例 vault。扣分:SKILL.md 本身在 status 一节截断,含隐藏假设(如 ce:compound、session-close、bird CLI 等未在本仓库内定义的外部依赖);无 CHANGELOG,维护责任与更新路径依赖单一未验证发布者。

5有效结果6 / 15 · 2.0/5

宣称的核心能力(trigram 搜索、自动 wikilink、图遍历、社区检测)与 17 个工具描述对应,命令产出格式具体、示例可直接使用,相对手工操作有明确增量价值。扣分:静态审阅无法验证产出正确性;对比表中自评数据未经第三方验证;daydream 成本估算无依据材料。

6证据核验4 / 10 · 2.0/5

有可审计的一手材料:源码依赖清单、release CI 工作流、示例 vault 说明。但仓库内未见提交的测试套件覆盖 skill 关键路径,skill 声明的行为无法在静态审阅中独立复现,多来源交叉验证有限,故不高于 5。

证据充分度: 评估于 2026年9月10日 审查版本 5a008aa32d88
使用前请注意
  • 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,更新路径不明确。
评估证据 [1][2][3][4][5]
查看完整评分方法 →

这个 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 美元)。

  1. 用 Obsidian 管理长期知识库的研究者,希望 Claude 写入的笔记自动接进图谱,而不是产生孤立文件
  2. 用 Claude Code 写代码的工程师,想把 docs/solutions/ 里沉淀的排错方案跨项目检索复用(与 /ce:compound 工作流配合)
  3. 做文献或话题调研的分析师,想用 analyze 和 graph 查看主题聚类、神节点和笔记之间的最短关联路径
  4. 需要把零散素材归档的知识工作者:把 PDF 报告、Gmail 讨论串、Twitter 长推、会议日程一键转成带 frontmatter 和摘要的库内笔记
  5. 想主动发现跨领域灵感的写作者,用 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 的差异化在于独立二进制、写入自动建链和完整的图谱分析管线。

常见问题

我的数据会上传吗?
按 README 声明,Librarian 完全本地运行,只读写磁盘文件并通过 stdio 与 Claude 通信,无网络调用、无遥测、无云存储。但注意 from web/gmail 等导入命令会通过 Claude.ai 的外部连接器获取内容。
没有 Obsidian 能用吗?
能。Librarian 直接操作任意文件夹里的 Markdown 文件,不需要 Obsidian 运行,两者也可同时打开互不冲突。
使用成本如何?
普通命令只是 Claude 调用本地 MCP 工具,无额外费用。唯一标注的持续成本是 daydream:每轮 50 对笔记约 0.40-0.50 美元(Sonnet 综合 + Haiku 评审)。
from claude 会泄露会话里的敏感信息吗?
技能明确要求综合步骤只提取概念性知识,不得复制原始凭据;但它读取的是本地 ~/.claude/projects/ 下的完整会话记录,含密钥的会话仍需用户自行注意归档范围。

相关 Skills