Obsidian 如何使用AI（MCP 使用篇）如果你已经按照上一篇「版本管理篇」把 Obsidian 笔记库用 Git

前言

如果你已经按照上一篇「版本管理篇」把 Obsidian 笔记库用 Git 管理起来了，那么这一篇会让你打开新世界的大门：让 AI 直接「读懂」并操作你的笔记。

这里的核心是 MCP（模型上下文协议） —— 一个让 AI 应用程序能够安全访问外部数据源的开放协议。你可以把它理解为 AI 世界的“USB 接口”：插上 MCP 服务器，AI 就能读写你的 Obsidian 笔记。

本文选择 Trae 作为演示工具（免费、中文友好、配置简单），但 MCP 是通用协议，同样适用于 Claude Desktop、Cursor 等。

核心理念

角色	工具	职责
源数据	Obsidian	存储笔记内容（Markdown 文件）
访问层	MCP 服务器	提供结构化、语义化的访问接口
消费者	Trae (AI)	通过自然语言操作笔记

一句话总结：把 Obsidian 当作源数据，用 MCP 作为访问层，让 AI 通过对话操作你的笔记库。

整体架构

你的 Obsidian 笔记库
        ↓
Local REST API 插件（Obsidian 侧，开启 API 服务）
        ↓
MCP 服务器（Trae 启动的一个本地进程）
        ↓
Trae AI（你发送自然语言指令）

你只需要配置一次，之后就可以在 Trae 里问：“列出我所有关于 XX 的笔记”或“总结一下上周的会议记录”。

前置条件

✅ Obsidian 已安装（电脑端）
✅ Trae 已安装
✅ Node.js 已安装（版本 20 或以上）

第一步：Obsidian 侧准备

1.1 安装 Local REST API 插件

打开 Obsidian → 设置 → 第三方插件 → 社区插件市场
搜索 Local REST API 并安装
点击启用

1.2 获取 API Key

启用插件后，进入它的设置页面，你会看到：

API Key：一串长字符（如 f9c28d...e2da）
本地地址：通常是 https://127.0.0.1:27124

⚠️ 记下这个 API Key，后续要用到。

1.3 保持 Obsidian 运行

MCP 通过 REST API 与 Obsidian 通信，Obsidian 必须保持打开状态。

💡 你只需要在一个库里启用这个插件，API 服务会自动跟随你切换的库窗口。

第二步：Trae 中配置 MCP

2.1 打开 MCP 设置

Trae 界面右上角 → 齿轮图标 → 选择 「MCP」

2.2 添加 MCP 服务器

点击 「添加」 → 「手动添加」，粘贴以下配置：

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-notes-mcp"],
      "env": {
        "OBSIDIAN_API_KEY": "你的API Key",
        "OBSIDIAN_REJECT_UNAUTHORIZED": "false"
      }
    }
  }
}

🔑 把 你的API Key 替换成第一步记下的那个 Key。

2.3 保存并启用

点击确认保存
在 MCP 服务器列表中找到 obsidian
把 「禁用」开关关掉

等待几秒，状态指示灯变为 绿色 ✅ 即表示连接成功。

第三步：验证连接

在 Trae 对话窗口中输入：

“列出我 Obsidian 笔记库根目录下的所有笔记”

如果能正常返回文件列表，说明配置完成。

如果返回错误，检查：

Obsidian 是否保持打开
Local REST API 插件是否已启用
API Key 是否复制完整（无多余空格）
Node.js 版本是否 20+（终端输入 node -v 查看）

多库连接：自动跟随

你只需要在一个库里启用 Local REST API，API 服务会跟着 Obsidian 窗口走。

你的操作	AI 连接的对象
Obsidian 切换到「工作笔记」库	AI 操作「工作笔记」库
Obsidian 切换到「个人知识」库	AI 自动跟随，操作「个人知识」库

不需要：

重启 Trae
修改 MCP 配置
为每个库单独配置

配置一次，三处生效

这套 MCP 配置完成后，你在 Trae 里可以做的事远不止“列文件”：

能力	示例指令
语义搜索	“找出去年关于‘微服务’但没加标签的笔记”
内容生成	“把笔记里关于‘Docker’的所有碎片整理成入门指南”
自动化整理	“给所有标题含‘待办’且内容提到‘明天’的笔记加标签 #urgent”
问答检索	“我上周关于 XX 项目的核心结论是什么？”

这些能力来自于 MCP 协议本身，与你用哪个 AI 客户端无关。

注意事项

要点	说明
API Key 每台设备不同	换电脑后重新生成，不要提交到 Git
离线可用	配置中的 MCP 服务器是 `stdio` 模式，断网也能用
Obsidian 必须打开	关闭 Obsidian 后 API 服务停止，MCP 无法连接
不要提交插件本体	`plugins/` 目录应被 Git 忽略（见版本管理篇）

总结

步骤	关键动作
1	Obsidian 装 Local REST API，记下 API Key
2	Trae MCP 设置中粘贴 JSON 配置
3	关掉禁用开关，等绿灯亮
4	问 AI：“列出我的笔记”

这套配置一次搞定，之后你就可以在 Trae 里通过自然语言和你的 Obsidian 笔记库对话了。

下一篇预告：Obsidian 如何使用AI（Trae 使用篇）