Obsidian 知识库操作

Obsidian 知识库操作

通过 MCP 工具操作 Obsidian Vault（dd-vault），支持笔记的查看、创建、编辑和搜索。

使用方法

• /obsidian - 查看当前打开的文件
• /obsidian search 关键词 - 在 vault 中搜索笔记
• /obsidian create 标题 - 在 Inbox 创建新笔记
• /obsidian daily - 查看/创建今天的 Daily Note
• /obsidian list 目录 - 列出指定目录的文件

MCP 工具映射

使用 mcp__obsidian__* 系列工具操作 vault：

操作	MCP 工具	说明
查看当前文件	mcp__obsidian__get_current_file	获取 Obsidian 中正在编辑的文件
列出文件	mcp__obsidian__get_workspace_files	列出 vault 所有文件
查看内容	mcp__obsidian__view	查看文件内容或目录列表
创建文件	mcp__obsidian__create	创建新笔记
编辑文件	mcp__obsidian__str_replace	替换文件中的文本
插入内容	mcp__obsidian__insert	在指定行插入文本
Obsidian API	mcp__obsidian__obsidian_api	直接调用 Obsidian API

Vault 结构（PARA 方法）

dd-vault/
├── Inbox/            # 快速捕捉，待整理
├── 项目/             # 有目标和截止时间的事项
├── 领域/             # 长期负责的领域
├── 资源/             # 参考资料与技术知识库
├── 归档/             # 不再活跃的内容
│   └── daily note/   # 日记归档（年/月/YYYY-MM-DD.md）
├── attachments/      # 附件资源
├── Templates/        # 笔记模板
└── Home.md           # 首页仪表盘

操作规范

创建笔记

1. 默认放入 Inbox/，除非用户指定位置
2. 必须包含 frontmatter：

   ---
   date: YYYY-MM-DD
   tags: [标签1, 标签2]
   ---
   

3. 使用 [[双向链接]] 关联笔记

Daily Note

• 路径：归档/daily note/年/月/YYYY-MM-DD.md
• 示例：归档/daily note/2026/02/2026-02-25.md

编辑笔记

1. 先用 view 查看当前内容
2. 用 str_replace 精确替换，或 insert 插入新内容
3. 保留已有 frontmatter，不删除用户标签

附件管理

• 图片 → attachments/images/
• PDF → attachments/documents/
• 绘图 → attachments/drawings/

执行步骤

查看当前文件

1. 调用 mcp__obsidian__get_current_file 获取当前文件
2. 展示文件路径和内容摘要

搜索笔记

1. 调用 mcp__obsidian__get_workspace_files 获取文件列表
2. 按关键词过滤匹配的文件
3. 用 mcp__obsidian__view 查看匹配文件内容

创建笔记

1. 确定目标路径（默认 Inbox/标题.md）
2. 生成带 frontmatter 的内容
3. 调用 mcp__obsidian__create 创建文件

前置条件

1. Obsidian 必须正在运行
2. obsidian-claude-code-mcp 插件已启用（端口 22360）
3. MCP server 已配置：claude mcp add obsidian --transport sse http://localhost:22360/sse

注意事项

• 不修改 .obsidian/ 配置目录
• 移动笔记时检查并更新附件引用路径
• MOC 页面使用 [MOC] 标签