Obsidian

Obsidian 是 Obsidian MD 团队开发的个人知识管理（PKM）工具，核心特点是将所有笔记存储为本地 Markdown 文件，文件之间可以用 [[]] 双向链接，并生成可视化图谱（Graph View）。由于文件格式为纯文本，用户完全拥有数据，不依赖任何云服务。

核心机制

• Vault（文库）：所有笔记的根文件夹，相当于本地知识库
• 双向链接：[[Note Name]] 语法自动创建笔记间的关联，Obsidian 自动维护反向链接
• Graph View：把所有链接关系渲染成可交互的图谱，直观展示知识结构
• 社区插件：通过社区插件机制扩展功能，Local REST API 插件可暴露一个本地 HTTP 端口，供外部程序（如 AI Agent）读写 Vault

与 AI Agent 的集成

通过 obsidian-local-rest-api 社区插件，Obsidian 可以暴露一个本地 REST 接口（默认 127.0.0.1:27124）。AI Agent 通过 Model Context Protocol（模型上下文协议） 连接这个接口后，可以：

• 读取、创建、更新任意笔记文件
• 在 Vault 内搜索内容
• 按路径管理文件夹结构

这是构建 Second Brain（AI 第二大脑）最常见的存储后端方案：Agent 负责读写和互链，Obsidian 负责本地存储和图谱可视化。

MCP 接入示例

claude mcp add-json obsidian-vault '{
  "type": "stdio",
  "command": "uvx",
  "args": ["mcp-obsidian"],
  "env": {
    "OBSIDIAN_API_KEY": "<your-api-key>",
    "OBSIDIAN_HOST": "127.0.0.1",
    "OBSIDIAN_PORT": "27124"
  }
}'

在 LLM Wiki 场景中的位置

Karpathy 的 LLM Wiki 模式——“知识编译一次、持续更新”——需要一个可持久化的纯文本存储后端。Obsidian Vault 正好满足这个条件：

• 文件是普通 .md，模型可以直接读写，无需专有 API
• 双向链接模拟 wiki 互链结构
• 图谱视图让知识结构可观测
• 与数据库或向量存储相比，文件系统的调试和版本控制更简单

同类工具（Notion、Bear、Roam Research、Logseq）大多有专有格式或云端锁定，对 Agent 写入不如 Obsidian 友好。

限制

• Obsidian 必须在运行状态，Local REST API 插件才能接收请求
• 免费但非开源（部分功能如 Obsidian Sync 收费）
• 插件生态质量参差，Local REST API 是社区插件，非官方维护

相关概念

• Second Brain（AI 第二大脑） — 以 Obsidian 为存储后端的个人 AI 知识库模式
• Model Context Protocol（模型上下文协议） — Agent 连接 Obsidian 的通信标准
• Agent Memory（Agent 记忆） — Obsidian Vault 是一种持久化 Agent 记忆的实现方式
• Skill（技能） — 存储在 Vault 中的可复用 Agent 工作流