Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Synchronize Zotero literature with an Obsidian vault, parse PDFs with MinerU, generate structured AI summaries, analyze citation networks, and control your vault via CLI—all while preserving existing notes.
npx claudepluginhub luffysolution-svg/obsidian-vault-mcpGenerate and write AI Summary sections for Obsidian literature notes. Use when the user asks to summarize a paper, or when prompted after Zotero import or MinerU parsing. 当用户请求总结论文、Zotero 导入或 MinerU 解析完成后有 AI Summary 空白时使用。
Drive the Obsidian desktop app via its CLI. Use when the user needs to open notes, query backlinks, read or set note properties, run Base queries, list tasks, take screenshots, reload plugins, or move/rename files with live wikilink updates inside a running Obsidian instance. 当需要控制 Obsidian 桌面应用、读取/写入属性、查询 Bases、列出任务或在 Obsidian 运行时移动/重命名文件时使用。
Analyse the citation and wikilink graph of an Obsidian vault using networkx. Use when the user needs citation network construction, community detection, connectivity metrics, or graph improvement suggestions. 当用户需要引用网络分析、社区检测、连通性指标或图谱改善建议时使用。
Extract and ingest document content into an Obsidian vault with MinerU. Use when Codex needs to check MinerU availability, parse a PDF or Office document into Markdown, ingest existing MinerU Markdown, create source notes from vault PDFs, or attach parsed full text back to a Zotero-derived literature note. 当用户提到 MinerU、全文解析、PDF 转 Markdown、文档抽取、全文挂接或 PDF 来源笔记时使用。
Work with local Obsidian vaults as linked knowledge bases. Use when the user needs to inspect, edit, organise, maintain, or analyse vault notes, YAML frontmatter, wikilinks, graph structure, wiki index/log, schema, or bulk edits. 当用户提到 Obsidian 仓库、笔记、YAML 属性、双链、图谱、批量修改、索引日志、模板或本地知识库维护时使用。
Admin access level
Server config contains admin-level keywords
Share bugs, ideas, or general feedback.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
AI thinking partner for your Obsidian vault — process, recall, synthesize, research with evidence-backed learning science
Karpathy-style LLM wiki for research papers. Ingest a URL / arXiv ID / DOI / PDF, write a structured summary into a local Obsidian vault, and maintain a finding-level knowledge graph via wikilinks + Dataview.
Second Brain automation for Obsidian vaults — entity management, ingestion, compression, and sync via Claude Code skills
11 research-hub skills: literature triage matrix, context compression, project orientation, design dialog, multi-AI routing, NotebookLM brief verification, paper-memory builder, paper summarizer, Zotero curator, the gap-to-topic decision dossier, and the research-hub orchestrator. Auto-discovered from skills/<name>/SKILL.md.
LLM-maintained knowledge base skill — structured wiki with Obsidian, milestone-based source clustering, proactive write-back, and autonomous lint
Transform academic PDFs into structured literature notes and critical-thinking canvases for Obsidian
默认只提供 17 个专注于 Zotero→MinerU→Obsidian 文献管道的 MCP 工具:
| 类别 | 工具 |
|---|---|
| Pipeline | obsidian_pipeline_doctor、obsidian_pipeline_config、obsidian_pipeline_migrate_layout |
| 文献导入 | obsidian_pipeline_ingest_item、obsidian_pipeline_ingest_collection |
| MinerU | obsidian_pipeline_parse_with_mineru、obsidian_pipeline_rename_mineru_images |
| Zotero | obsidian_zotero_ping、obsidian_zotero_search_items、obsidian_zotero_list_collections、obsidian_zotero_get_item、obsidian_zotero_get_children、obsidian_zotero_list_pdf_attachments |
| Vault 基础 | obsidian_read_file、obsidian_write_file、obsidian_search、obsidian_update_properties |
图谱分析、Wiki 维护、Canvas/Bases/Dataview 视图、Obsidian CLI 控制等高级工作流已转为 Skills,通过 Claude Code 或 Codex 调用:
| Skill | 功能 |
|---|---|
obsidian-vault | 图谱、lint、wiki、schema、批量编辑、文件管理 |
obsidian-cli | Obsidian 桌面 CLI 控制 |
obsidian-views | Canvas、Bases、Dataview |
obsidian-graph | 引用网络、社区检测、连通性分析 |
obsidian-mineru | MinerU 直接解析、批量处理 |
obsidian-zotero | Zotero 搜索与文献导入 |
Vault-local pipeline config lives in .obsidian-vault-pipeline.json:
{
"literatureFolder": "literature",
"zoteroAttachmentsFolder": "attachments/zotero",
"mineruAttachmentsFolder": "attachments/mineru",
"noteFilenamePattern": "{firstAuthor} {year} - {shortTitle}",
"pdfFilenamePattern": "{shortTitle}",
"mineruMarkdownName": "paper.md",
"mineruImagesIndexName": "images-index.md"
}
面向 Codex、Claude Code 和 OpenCode 的本地 MCP 插件,将本地 Obsidian vault 维护成可持续增长的双链知识库。
English README | 安装配置教程 | 技术文档 | 文档站
方式一:PyPI 安装(推荐)
pip install zotero-obsidian-mcp
obsidian-vault-mcp --doctor --doctor-format text --vault /path/to/your-vault
方式二:源码安装(开发者 / 跟进最新提交)
git clone https://github.com/luffysolution-svg/obsidian-vault-mcp.git
cd obsidian-vault-mcp
pip install -e .
obsidian-vault-mcp --doctor --doctor-format text --vault /path/to/your-vault
将本目录注册为 Codex 本地插件,或将 MCP server 添加到 Claude Code 或 OpenCode,然后重启或重新加载 MCP 客户端。个人 vault 路径、Zotero 存储路径、API token 和私有笔记内容只保存在本地配置中,不要提交到仓库。
zotero:// 链接。--doctor 就绪检查脚本(Zotero、MinerU、vault 配置)。pip install 安装后 skills 位于 Python 包目录内;clone 源码安装后位于仓库根目录 skills/。在本地 MCP 配置中设置 OBSIDIAN_VAULT_PATH,或在每次工具调用时传入 vault_path。.mcp.json 默认使用 auto,会通过本地 Obsidian CLI 获取当前活动 vault,CLI 不可用时回退到进程工作目录。
{
"OBSIDIAN_VAULT_PATH": "auto",
"OBSIDIAN_CLI_COMMAND": "obsidian"
}
CLI 封装需要 Obsidian 1.12.7 或更高版本,且 obsidian 命令在 PATH 中。
Zotero 工具需要 Zotero Desktop 本地 API 运行在 http://127.0.0.1:23119/api,可通过 ZOTERO_LOCAL_API 覆盖。
MinerU 支持是可选的。已有 MinerU Markdown 可直接导入,无需安装 MinerU。如需直接解析文档,安装 mineru-open-api 并使用 obsidian_mineru_* 工具。flash-extract 无需 token;精确 extract 可能需要 MinerU token。本插件不会自动安装 MinerU CLI、MinerU MCP、Zotero Desktop 或 Obsidian CLI。
与 Zotero 联动的推荐三步工作流:
obsidian_pipeline_ingest_item(传入 zotero_key)→ 将文献导入 literature/,生成完整 YAML、笔记和批注。obsidian_pipeline_parse_with_mineru(传入 zotero_key)→ 解析 PDF,在 attachments/mineru/ 生成全文笔记,同时向文献 note 的 YAML 追加 MinerU 跳转链接。MinerU 提取会调用多个 MinerU/OpenXLab 端点。使用 VPN、代理或 fake-IP DNS 时,请确保以下域名可直连:
mineru.netmineru.oss-cn-shanghai.aliyuncs.comcdn-mineru.openxlab.org.cn*.openxlab.org.cn常见失败场景:解析任务和 OSS 上传成功,但从 cdn-mineru.openxlab.org.cn 下载 full.md 时出现 TLS/EOF 错误。遇到此问题请先检查代理/DNS 规则。
NO_PROXY 在显式 HTTP 代理场景下可能有帮助,但在全局代理、TUN 或 fake-IP 路由模式下经常不会生效。这种情况下通常需要直接在代理客户端里配置直连或 DNS bypass 规则。
默认要求路径解析到包含 .obsidian 的文件夹。只有在明确使用普通 Markdown 文件夹时才设置 OBSIDIAN_ALLOW_NON_VAULT=true。
可在 vault 根目录的 .obsidian-vault-mcp.json 或 .obsidian/obsidian-vault-mcp.json 中保存可复用的默认值。工具参数显式传入时优先级更高。
{
"literatureFolder": "01-literature",
"mineruSourceFolder": "02-sources/mineru",
"pdfSourceFolder": "02-sources/pdf",
"entitiesFolder": "entities",
"conceptsFolder": "concepts",
"zoteroAttachmentsFolder": "assets/zotero",
"zoteroAttachmentNameStrategy": "zotero_key",
"indexPath": "index.md",
"logPath": "log.md",
"templateFolder": "Templates",
"defaultTemplate": "Literature"
}