Obsidian MCP 安装与基础使用指南-二趣网

Obsidian MCP 安装与基础使用指南

关键词：Obsidian、MCP、Model Context Protocol、Local REST API、AI 笔记管理
适用读者：希望用 AI 助手（如 Claude、Cursor、Qoder 等）管理 Obsidian 笔记库的用户

MCP（Model Context Protocol）是由 Anthropic 于 2024 年推出的开放协议标准，旨在为 AI 模型提供一种统一、安全的方式来连接外部数据源和工具。

你可以把它理解为 AI 世界的「USB 接口」——不管是什么工具或数据源，只要实现了 MCP 协议，AI 就能用同一种方式去调用。

AI 客户端（Claude / Cursor / Qoder ...） │ ▼ MCP Server（MCP 服务器） │ ▼ 外部工具 / 数据源（Obsidian、数据库、API ...）

通过 Obsidian MCP，AI 助手可以直接操作你的 Obsidian 笔记库，包括：

能力	说明
📄 文件管理	创建、读取、修改、删除、移动笔记
🔍 搜索	全文搜索、结构化元数据搜索
✂️ 精准编辑	针对某个标题、区块引用、Frontmatter 字段进行局部修改
📅 周期笔记	获取/创建日笔记、周笔记、月笔记等
🏷️ 标签管理	列出所有标签及其使用次数
⚡ 命令执行	触发 Obsidian 内置命令
📂 目录浏览	列出文件夹内容

目前有两种主流的 Obsidian MCP 方案：

特性	方案 A：Local REST API 内置 MCP	方案 B：第三方 mcp-obsidian
维护者	coddingtonbear（Obsidian 插件作者）	MarkusPfundstein（社区开发者）
运行方式	在 Obsidian 内部运行，无需额外进程	需要`uvx`或`uv`启动独立进程
协议支持	Streamable HTTP	stdio
功能完整性	✅ 更完整（活跃文件、命令执行、标签等）	⚠️ 基础功能（文件 CRUD、搜索）