Obsidian Vault MCP

连接 Zotero、MinerU、Obsidian 与 AI Agent 的本地优先文献研究工作流。

Version 3.0.1

快速开始 完整安装 GitHub 更新日志

从文献到知识库

Zotero Desktop → 稳定 zoteroKey → Markdown 主笔记 + PDF
→ MinerU 全文、图片与公式 → 31 MCP Tools → 7 Agent Skills
→ 5 类 Analysis → Obsidian Base 与知识库
31
MCP Tools
7
Agent Skills
5
Analysis Types
1
Analysis Base

核心能力

Zotero 与附件

以父条目 `zoteroKey` 作为稳定身份,导入、同步并管理 PDF。

MinerU

解析全文、图片和公式,并写入按论文隔离的相对路径。

Analysis 与 Wiki

五类结构化分析、Literature/Analysis Base 与可追溯 Wiki。

可恢复写入

dry-run、事务、备份、冲突保护、原子替换和 rollback。

Agent 工作流

支持 Codex、Claude Code、OpenCode、Pi、Hermes 与 WorkBuddy。

快速安装(发布后)

uv tool install "zotero-obsidian-mcp==3.0.1"
obsidian-vault-mcp --help
obsidian-vault-mcp call literature_version --json '{}'
uvx --from "zotero-obsidian-mcp==3.0.1" obsidian-vault-mcp --help

文档

完整安装

环境、包管理器、Vault、Zotero、MinerU、验证与隐私。

用户配置

唯一 Vault 配置文件、Schema 与 Skill 自定义区域。

Zotero 导入与同步

父条目、附件和同步策略。

MinerU 解析

全文章节、图片、公式与事务输出。

Analysis 与 Skills

五类输出、Analysis.base 和七个工作流。

Agent 客户端

实际安装器支持的客户端与方式。

MCP Tools

由运行时注册表生成的 31 工具参考。

故障排查

doctor、verify、路径和客户端问题。

开发与贡献

Pages 来源、测试和贡献方式。

实际界面

Obsidian 中的 Literature Base

English documentation