更新日期2026-06-09适用版本Cherry Studio ≥ v1.1.13、Obsidian ≥ 1.7.2零、快速选择我该用哪种方式在开始之前先确认你的需求选择最适合的方案方案难度是否需要 Obsidian 插件能做什么推荐场景方案 ACherry Studio 原生导出⭐ 极低❌ 不需要将对话一键导出为 Obsidian 笔记只想把 AI 对话保存到 Obsidian方案 B文件系统 MCP⭐⭐ 低❌ 不需要AI 直接读写 Vault 中的 Markdown 文件需要 AI 主动创建/搜索/修改笔记方案 CObsidian MCPREST API⭐⭐⭐ 中✅ 需要 Local REST API全文检索、反向链接、执行 Obsidian 命令等高级功能构建 AI 知识库深度整合新手建议先用方案 A 体验需要更多功能再升级到方案 B 或 C。一、基本概念1.1 什么是 Cherry StudioCherry Studio 是一款开源的桌面端 AI 对话客户端支持多种大语言模型如 GPT、Claude、DeepSeek、Qwen 等并内置了MCPModel Context Protocol支持和原生 Obsidian 导出功能[1][2]。社区推荐组合Cherry Studio客户端 阿里 Qwen大模型优势是免费、操作简单、无需特殊网络环境 [4]。1.2 什么是 MCPMCPModel Context Protocol是由 Anthropic 于 2024 年 11 月推出的一种开放协议允许 AI 模型通过标准化接口访问外部工具和数据源 [4]。MCP 有两种运行模式 [3][5]Stdio 模式用于连接本地服务如文件系统、本地软件需要本地环境支持SSE 模式用于连接远程服务如在线 API通常只需一个 URL大多数 Obsidian 相关的 MCP 服务采用 Stdio 模式。1.3 三种操作 Obsidian 的方式概览方式原理优点缺点Cherry Studio 原生导出类似 Obsidian Web Clipper直接将对话内容写入 Vault [1][2]零配置、无需插件只能导出不能搜索/读取现有笔记文件系统 MCP直接通过文件系统读写 Vault 中的 .md 文件简单直接、无需 Obsidian 插件无法使用 Obsidian 的高级功能反向链接、Dataview 等Obsidian MCPREST API通过 Local REST API 插件与 Obsidian 交互 [3][5]功能最全、可搜索、可执行 Obsidian 命令需要额外安装插件和配置二、方案 ACherry Studio 原生导出最简单这是 Cherry Studio 内置的功能无需安装任何 Obsidian 插件、无需配置 MCP直接将对话导出为 Obsidian 笔记 [1][2]。2.1 前提条件Cherry Studio 版本 ≥ v1.1.13Obsidian 版本 ≥1.7.2避免长对话导入失败2.2 配置步骤第一步在 Cherry Studio 中配置 Obsidian打开 Cherry Studio进入设置 → 数据设置 → Obsidian 配置下拉框会自动出现你本机打开过的 Obsidian 库名选择目标库 [1][2]可选设置全局标签所有导出对话都会自动打上该标签第二步导出对话导出完整对话在对话界面右键点击对话选择导出 → 导出到 Obsidian在弹出的窗口中配置保管库选择目标 Obsidian 库路径选择存放导出笔记的文件夹笔记属性Properties可选择添加标签tags、创建时间created、来源source处理方式三选一新建如果存在就覆盖创建新笔记同名则覆盖此模式附带 Properties前置在已有同名笔记开头添加内容追加在已有同名笔记末尾添加内容导出单条对话点击对话下方的三条杠菜单选择导出 → 导出到 Obsidian后续配置同上⚠️注意仅「新建」模式会附带 Properties属性「前置」和「追加」模式不会附带。三、方案 B文件系统 MCP推荐进阶用户通过文件系统 MCPAI 可以直接在对话中读写 Obsidian Vault 中的.md文件无需 Obsidian 运行。3.1 前置准备确保已安装Node.js版本 ≥ 18。验证安装node-vnpm-v3.2 在 Cherry Studio 中配置文件系统 MCP打开 Cherry Studio进入设置 → MCP 服务或 MCP Servers添加新的 MCP 服务器使用以下JSON 配置{mcpServers:{obsidian-filesystem:{command:npx,args:[-y,modelcontextprotocol/server-filesystem,/path/to/your/Obsidian/Vault]}}}注意将/path/to/your/Obsidian/Vault替换为你的 Obsidian Vault 的实际路径。Windows 示例C:/Users/用户名/Documents/MyVaultmacOS 示例/Users/用户名/Documents/MyVaultLinux 示例/home/用户名/MyVault3.3 常用操作指令配置完成后在 Cherry Studio 对话中直接使用自然语言即可# 创建新笔记 帮我在 Vault 中创建 学习笔记/MCP协议.md内容如下 --- tags: [MCP, AI] created: 2025-07-15 --- # MCP 协议学习笔记 ... # 搜索笔记 在 Vault 中搜索所有包含 MCP 关键词的 Markdown 文件 # 读取笔记 读取 Vault 中的 日常/2025-07-15.md 文件内容 # 修改笔记 在 项目/MyProject.md 文件末尾追加以下内容- [ ] 新任务 # 汇总整理 帮我整理 Vault 中所有关于 Python 的笔记汇总到一个新文件 Python知识索引.md 中四、方案 CObsidian MCPREST API功能最全通过 Obsidian 的 Local REST API 插件 mcp-obsidian 工具实现最完整的 Obsidian 操作能力 [3][5]。4.1 前置准备安装 uv用于运行 uvx 命令Windows以管理员身份运行 PowerShell执行powershell-ExecutionPolicy ByPass-cirm https://astral.sh/uv/install.ps1 | iex安装完成后重启计算机macOS / Linuxcurl-LsSfhttps://astral.sh/uv/install.sh|sh安装 Node.js从 nodejs.org 下载并安装 LTS 版本。4.2 在 Obsidian 端配置第一步安装 Local REST API 插件打开 Obsidian 的设置 → 第三方插件 → 社区插件市场搜索“Local REST API”并安装启用插件后在插件设置中记下 API Key如果没有则生成一个确认端口号默认27124第二步授权 API 访问访问https://coddingtonbear.github.io/obsidian-local-rest-api/点击右下角的「Authorize」输入刚才在插件设置中获取的 API Key授权成功即可第三步获取 Vault 路径点击 Obsidian 左下角的仓库管理选择**「在访达中显示仓库文件夹」macOS或「在资源管理器中显示」**Windows复制仓库的完整路径4.3 在 Cherry Studio 中配置 MCP在 Cherry Studio 的设置 → MCP 服务中添加以下配置命令uv tool run mcp-obsidian --vault-path 你的Obsidian仓库路径环境变量OBSIDIAN_API_KEY你的Local_Rest_API_Key也可以使用 JSON 格式{mcpServers:{obsidian-api:{command:uv,args:[tool,run,mcp-obsidian,--vault-path,/path/to/your/Obsidian/Vault],env:{OBSIDIAN_API_KEY:你的Local_Rest_API_Key}}}}4.4 高级操作能力通过方案 C 可以实现方案 B 无法做到的功能操作说明示例指令全文搜索在 Vault 中全文检索搜索包含 Cherry Studio 的笔记反向链接查看笔记的引用关系查看 MCP协议 的反向链接每日笔记打开或创建每日笔记打开今天的每日笔记执行 Obsidian 命令调用任意 Obsidian 命令执行 插入模板 命令Frontmatter 操作读写 YAML 元数据更新 项目A.md 的 status 为 done批量操作跨文件操作给 Projects 目录下所有笔记添加 tag #active五、将 AI 生成内容输出到指定文档5.1 方式一使用 Cherry Studio 原生导出推荐右键对话 → 导出 → 导出到 Obsidian → 选择路径和处理方式。最直接的方式 [1][2]。5.2 方式二在对话中直接指定路径适用于方案 B 或 C直接在对话中告诉 AI请将以下内容保存到 Obsidian Vault 中的 输出/MCPForObsidian.md如果文件不存在MCP 工具会自动创建。5.3 方式三MCP 工具链自动化结合多个 MCP 工具实现复杂工作流AI 生成内容文件系统 MCP 写入指定 .md 文件可选Obsidian MCP 触发索引更新或执行模板命令六、高级技巧6.1 模板化输出预先在 Obsidian 中创建模板文件然后让 AI 按模板格式生成请按照 模板/笔记模板.md 的格式生成一篇关于 MCP 协议详解 的笔记 并保存到 技术/MCP协议详解.md6.2 批量操作在 Projects 目录下为每个子目录创建 README.md汇总该项目的所有相关笔记链接6.3 与 Obsidian 插件联动通过方案 C 可以操作 Dataview、Calendar、Kanban 等插件执行 Obsidian 命令 Dataview: 刷新所有视图6.4 推荐模型社区使用体感排名 [4]Claude 4.5 GPT-5 Gemini 2.5 Qwen3-Max DeepSeek免费推荐Cherry Studio 阿里 Qwen无需特殊网络环境[4]七、常见问题排查7.1 Cherry Studio 原生导出问题问题解决方案导出失败确保 Obsidian 版本 ≥ 1.7.2找不到库确保在本机用 Obsidian 打开过该库对话太长导出失败升级 Obsidian 到最新版本或分段导出7.2 MCP 连接问题问题解决方案连接超时检查 Obsidian 是否正在运行REST API 插件是否启用认证失败确认 API Key 正确确认已完成网页端授权 [5]uv tool run命令失败确保已正确安装 uv尝试重启终端npx命令失败确保 Node.js ≥ 18 已正确安装端口冲突检查27124端口是否被其他程序占用7.3 文件系统权限问题确保 Cherry Studio 有权限访问 Obsidian Vault 目录macOS 用户可能需要授予完全磁盘访问权限路径中包含空格时使用引号包裹7.4 Windows 特别提示Windows 系统在环境配置和网络方面比 Mac 更容易遇到问题 [3][5]。如果遇到无法解决的错误以管理员身份运行终端重启计算机让环境变量生效考虑使用方案 A原生导出绕过复杂配置八、相关资源官方资源Cherry Studio 官方文档 - Obsidian 配置Cherry Studio GitHubMCP 协议规范Obsidian Local REST API 插件社区 MCP 工具mcp-obsidian — Python 实现的 Obsidian REST API MCPevc-team-relay-mcp — 支持团队协作的 Obsidian MCPmcp-obsidian (PyPI) —uv tool run mcp-obsidian对应的包MCP 服务聚合网站MCP.so — 中文友好的 MCP 服务目录近 8000 服务器Smithery.ai — 英文 MCP 服务平台学习资源Awesome-MCP-ZH — 中文 MCP 资源合集MCP 从入门到实战 — 零基础配置指南提示本文档本身即是一个示例——你可以通过 Cherry Studio MCP 将 AI 生成的内容直接保存到 Obsidian Vault 中。三种方案从简到繁按需选择即可。
Cherry Studio 通过 MCP 接口操作 Obsidian 完全指南
更新日期2026-06-09适用版本Cherry Studio ≥ v1.1.13、Obsidian ≥ 1.7.2零、快速选择我该用哪种方式在开始之前先确认你的需求选择最适合的方案方案难度是否需要 Obsidian 插件能做什么推荐场景方案 ACherry Studio 原生导出⭐ 极低❌ 不需要将对话一键导出为 Obsidian 笔记只想把 AI 对话保存到 Obsidian方案 B文件系统 MCP⭐⭐ 低❌ 不需要AI 直接读写 Vault 中的 Markdown 文件需要 AI 主动创建/搜索/修改笔记方案 CObsidian MCPREST API⭐⭐⭐ 中✅ 需要 Local REST API全文检索、反向链接、执行 Obsidian 命令等高级功能构建 AI 知识库深度整合新手建议先用方案 A 体验需要更多功能再升级到方案 B 或 C。一、基本概念1.1 什么是 Cherry StudioCherry Studio 是一款开源的桌面端 AI 对话客户端支持多种大语言模型如 GPT、Claude、DeepSeek、Qwen 等并内置了MCPModel Context Protocol支持和原生 Obsidian 导出功能[1][2]。社区推荐组合Cherry Studio客户端 阿里 Qwen大模型优势是免费、操作简单、无需特殊网络环境 [4]。1.2 什么是 MCPMCPModel Context Protocol是由 Anthropic 于 2024 年 11 月推出的一种开放协议允许 AI 模型通过标准化接口访问外部工具和数据源 [4]。MCP 有两种运行模式 [3][5]Stdio 模式用于连接本地服务如文件系统、本地软件需要本地环境支持SSE 模式用于连接远程服务如在线 API通常只需一个 URL大多数 Obsidian 相关的 MCP 服务采用 Stdio 模式。1.3 三种操作 Obsidian 的方式概览方式原理优点缺点Cherry Studio 原生导出类似 Obsidian Web Clipper直接将对话内容写入 Vault [1][2]零配置、无需插件只能导出不能搜索/读取现有笔记文件系统 MCP直接通过文件系统读写 Vault 中的 .md 文件简单直接、无需 Obsidian 插件无法使用 Obsidian 的高级功能反向链接、Dataview 等Obsidian MCPREST API通过 Local REST API 插件与 Obsidian 交互 [3][5]功能最全、可搜索、可执行 Obsidian 命令需要额外安装插件和配置二、方案 ACherry Studio 原生导出最简单这是 Cherry Studio 内置的功能无需安装任何 Obsidian 插件、无需配置 MCP直接将对话导出为 Obsidian 笔记 [1][2]。2.1 前提条件Cherry Studio 版本 ≥ v1.1.13Obsidian 版本 ≥1.7.2避免长对话导入失败2.2 配置步骤第一步在 Cherry Studio 中配置 Obsidian打开 Cherry Studio进入设置 → 数据设置 → Obsidian 配置下拉框会自动出现你本机打开过的 Obsidian 库名选择目标库 [1][2]可选设置全局标签所有导出对话都会自动打上该标签第二步导出对话导出完整对话在对话界面右键点击对话选择导出 → 导出到 Obsidian在弹出的窗口中配置保管库选择目标 Obsidian 库路径选择存放导出笔记的文件夹笔记属性Properties可选择添加标签tags、创建时间created、来源source处理方式三选一新建如果存在就覆盖创建新笔记同名则覆盖此模式附带 Properties前置在已有同名笔记开头添加内容追加在已有同名笔记末尾添加内容导出单条对话点击对话下方的三条杠菜单选择导出 → 导出到 Obsidian后续配置同上⚠️注意仅「新建」模式会附带 Properties属性「前置」和「追加」模式不会附带。三、方案 B文件系统 MCP推荐进阶用户通过文件系统 MCPAI 可以直接在对话中读写 Obsidian Vault 中的.md文件无需 Obsidian 运行。3.1 前置准备确保已安装Node.js版本 ≥ 18。验证安装node-vnpm-v3.2 在 Cherry Studio 中配置文件系统 MCP打开 Cherry Studio进入设置 → MCP 服务或 MCP Servers添加新的 MCP 服务器使用以下JSON 配置{mcpServers:{obsidian-filesystem:{command:npx,args:[-y,modelcontextprotocol/server-filesystem,/path/to/your/Obsidian/Vault]}}}注意将/path/to/your/Obsidian/Vault替换为你的 Obsidian Vault 的实际路径。Windows 示例C:/Users/用户名/Documents/MyVaultmacOS 示例/Users/用户名/Documents/MyVaultLinux 示例/home/用户名/MyVault3.3 常用操作指令配置完成后在 Cherry Studio 对话中直接使用自然语言即可# 创建新笔记 帮我在 Vault 中创建 学习笔记/MCP协议.md内容如下 --- tags: [MCP, AI] created: 2025-07-15 --- # MCP 协议学习笔记 ... # 搜索笔记 在 Vault 中搜索所有包含 MCP 关键词的 Markdown 文件 # 读取笔记 读取 Vault 中的 日常/2025-07-15.md 文件内容 # 修改笔记 在 项目/MyProject.md 文件末尾追加以下内容- [ ] 新任务 # 汇总整理 帮我整理 Vault 中所有关于 Python 的笔记汇总到一个新文件 Python知识索引.md 中四、方案 CObsidian MCPREST API功能最全通过 Obsidian 的 Local REST API 插件 mcp-obsidian 工具实现最完整的 Obsidian 操作能力 [3][5]。4.1 前置准备安装 uv用于运行 uvx 命令Windows以管理员身份运行 PowerShell执行powershell-ExecutionPolicy ByPass-cirm https://astral.sh/uv/install.ps1 | iex安装完成后重启计算机macOS / Linuxcurl-LsSfhttps://astral.sh/uv/install.sh|sh安装 Node.js从 nodejs.org 下载并安装 LTS 版本。4.2 在 Obsidian 端配置第一步安装 Local REST API 插件打开 Obsidian 的设置 → 第三方插件 → 社区插件市场搜索“Local REST API”并安装启用插件后在插件设置中记下 API Key如果没有则生成一个确认端口号默认27124第二步授权 API 访问访问https://coddingtonbear.github.io/obsidian-local-rest-api/点击右下角的「Authorize」输入刚才在插件设置中获取的 API Key授权成功即可第三步获取 Vault 路径点击 Obsidian 左下角的仓库管理选择**「在访达中显示仓库文件夹」macOS或「在资源管理器中显示」**Windows复制仓库的完整路径4.3 在 Cherry Studio 中配置 MCP在 Cherry Studio 的设置 → MCP 服务中添加以下配置命令uv tool run mcp-obsidian --vault-path 你的Obsidian仓库路径环境变量OBSIDIAN_API_KEY你的Local_Rest_API_Key也可以使用 JSON 格式{mcpServers:{obsidian-api:{command:uv,args:[tool,run,mcp-obsidian,--vault-path,/path/to/your/Obsidian/Vault],env:{OBSIDIAN_API_KEY:你的Local_Rest_API_Key}}}}4.4 高级操作能力通过方案 C 可以实现方案 B 无法做到的功能操作说明示例指令全文搜索在 Vault 中全文检索搜索包含 Cherry Studio 的笔记反向链接查看笔记的引用关系查看 MCP协议 的反向链接每日笔记打开或创建每日笔记打开今天的每日笔记执行 Obsidian 命令调用任意 Obsidian 命令执行 插入模板 命令Frontmatter 操作读写 YAML 元数据更新 项目A.md 的 status 为 done批量操作跨文件操作给 Projects 目录下所有笔记添加 tag #active五、将 AI 生成内容输出到指定文档5.1 方式一使用 Cherry Studio 原生导出推荐右键对话 → 导出 → 导出到 Obsidian → 选择路径和处理方式。最直接的方式 [1][2]。5.2 方式二在对话中直接指定路径适用于方案 B 或 C直接在对话中告诉 AI请将以下内容保存到 Obsidian Vault 中的 输出/MCPForObsidian.md如果文件不存在MCP 工具会自动创建。5.3 方式三MCP 工具链自动化结合多个 MCP 工具实现复杂工作流AI 生成内容文件系统 MCP 写入指定 .md 文件可选Obsidian MCP 触发索引更新或执行模板命令六、高级技巧6.1 模板化输出预先在 Obsidian 中创建模板文件然后让 AI 按模板格式生成请按照 模板/笔记模板.md 的格式生成一篇关于 MCP 协议详解 的笔记 并保存到 技术/MCP协议详解.md6.2 批量操作在 Projects 目录下为每个子目录创建 README.md汇总该项目的所有相关笔记链接6.3 与 Obsidian 插件联动通过方案 C 可以操作 Dataview、Calendar、Kanban 等插件执行 Obsidian 命令 Dataview: 刷新所有视图6.4 推荐模型社区使用体感排名 [4]Claude 4.5 GPT-5 Gemini 2.5 Qwen3-Max DeepSeek免费推荐Cherry Studio 阿里 Qwen无需特殊网络环境[4]七、常见问题排查7.1 Cherry Studio 原生导出问题问题解决方案导出失败确保 Obsidian 版本 ≥ 1.7.2找不到库确保在本机用 Obsidian 打开过该库对话太长导出失败升级 Obsidian 到最新版本或分段导出7.2 MCP 连接问题问题解决方案连接超时检查 Obsidian 是否正在运行REST API 插件是否启用认证失败确认 API Key 正确确认已完成网页端授权 [5]uv tool run命令失败确保已正确安装 uv尝试重启终端npx命令失败确保 Node.js ≥ 18 已正确安装端口冲突检查27124端口是否被其他程序占用7.3 文件系统权限问题确保 Cherry Studio 有权限访问 Obsidian Vault 目录macOS 用户可能需要授予完全磁盘访问权限路径中包含空格时使用引号包裹7.4 Windows 特别提示Windows 系统在环境配置和网络方面比 Mac 更容易遇到问题 [3][5]。如果遇到无法解决的错误以管理员身份运行终端重启计算机让环境变量生效考虑使用方案 A原生导出绕过复杂配置八、相关资源官方资源Cherry Studio 官方文档 - Obsidian 配置Cherry Studio GitHubMCP 协议规范Obsidian Local REST API 插件社区 MCP 工具mcp-obsidian — Python 实现的 Obsidian REST API MCPevc-team-relay-mcp — 支持团队协作的 Obsidian MCPmcp-obsidian (PyPI) —uv tool run mcp-obsidian对应的包MCP 服务聚合网站MCP.so — 中文友好的 MCP 服务目录近 8000 服务器Smithery.ai — 英文 MCP 服务平台学习资源Awesome-MCP-ZH — 中文 MCP 资源合集MCP 从入门到实战 — 零基础配置指南提示本文档本身即是一个示例——你可以通过 Cherry Studio MCP 将 AI 生成的内容直接保存到 Obsidian Vault 中。三种方案从简到繁按需选择即可。
