Obsidian MCP Server MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

八个工具，涵盖笔记、标签、前期事项和搜索
追加/前置/覆盖更新模式—代理不必重新生成整个文件
原子前置关键级操作
整个保险库的全局模糊搜索
缓存层，实现更快的重复读取

实时演示

实际使用效果

obsidian-mcp-server.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-server"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： Obsidian MCP Server

从任何MCP客户将想法记录到今天的每日笔记中

👤 生活在聊天中的Obsidian用户 ⏱ ~5 min beginner

何时使用： 您正在与Claude进行对话，并希望在不切换应用程序的情况下将想法保存到您的保管库中。

前置条件

启用了本地REST API插件的Obsidian — 社区插件→安装“本地REST API”→复制API密钥
MCP客户端配置了OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL — 请参阅配置块；基本URL通常为http://127.0.0.1 ： 27123

步骤

检查每日备注是否存在

在Daily/2026-04-17.md下列出备注。✓ 已复制

→ 文件路径已确认或“未找到”
追加捕获

Append '- Idea: try X for the caching bug' to Daily/2026-04-17.md.✓ 已复制

→ 追加已确认，不覆盖之前的条目

结果： 代理可以添加的运行日记，从不抨击。

注意事项

当您的意思是追加时，使用覆盖模式 — 始终默认在每日备注上附加或前置；保存覆盖以用于新草稿

搭配使用： filesystem

将一周的笔记转化为评价文档

👤 知识工作者进行每周审核 ⏱ ~20 min intermediate

何时使用： 您需要对本周零散的音符进行周五综合。

前置条件

已标记或注明日期的备注 — 使用# weekly或Daily/文件夹

步骤

搜索本周备注

全局搜索：本周在每日/下修改的笔记。✓ 已复制

→ 5–7个文件路径列表
阅读每个

阅读每日备注，并按主题进行总结。✓ 已复制

→ 主题项目符号，而不是原始连接
撰写评价

将摘要写入评价/2026-W16.md ；添加Frontmatter状态：评价，标签： [WEEKLY]。✓ 已复制

→ 具有正确前置内容的新文件

结果： 由原材料构建的每周审核备注，无需手动复制粘贴。

搭配使用： github

整合整个保管库中凌乱的标签

👤 有机增长的保险库，现在有#工作/#工作/#工作变体 ⏱ ~30 min intermediate

何时使用： 由于重复和近似重复，标签列表太长。

步骤

当前标签

使用obsidian_manage_tags列出按使用情况排序的所有标签。✓ 已复制

→ 标签计数显示重复项
建议映射

提出一个规范集和旧→新映射。✓ 已复制

→ 小巧、可审核的表格
批量申请

确认后，使用映射重命名整个保管库的标签。✓ 已复制

→ 每个注释汇总的标签操作

结果： 您可以实际导航的清除标签分类。

注意事项

一次重写数百个笔记，无需备份 — 首先将vault提交到git ；查看diff

搭配使用： git

将网页剪辑放入研究收件箱并自动标记

👤 研究人员，分析师，任何有快船习惯的人 ⏱ ~15 min beginner

何时使用： 收件箱/文件夹的堆积速度超出了您的处理速度。

前置条件

指定的收件箱/文件夹 — 在保管库中创建

步骤

列出收件箱

在收件箱/下列出未标记的备注。✓ 已复制

→ 待处理项目的路径
分类和标记

对于每个，根据内容建议1–3个标签，然后使用obsidian_manage_tags应用。✓ 已复制

→ 通过frontmatter原子添加的标签

结果： 收件箱保持较小；新剪辑会自动整理。

搭配使用： fetch

组合

与其他 MCP 搭配，撬动十倍杠杆

obsidian-mcp-server + fetch

使用fetch剪切URL ，然后将其写入收件箱/

获取https://...并将已清除的摘要保存到Inbox/YYYY-MM-DD-title.md ，并使用正确的frontmatter。✓ 已复制

obsidian-mcp-server + github

将合并的公关摘要复制到Projects/<repo>.md

查找本周合并的PR ，并在Projects/acme-api.md的# # Week 16下追加摘要。✓ 已复制

obsidian-mcp-server + git

对保管库进行版本控制并提交批量更改

标记清理后，在提交之前，在保管库上运行git diff并进行汇总。✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用
obsidian_read_note	path: str	在编辑或总结备注之前阅读备注
obsidian_update_note	path: str, content: str, mode: 'append'\|'prepend'\|'overwrite'	添加或替换备注内容—除非重写，否则默认追加
obsidian_search_replace	path: str, find: str, replace: str	有针对性的笔记内编辑，而无需重新生成整个文件
obsidian_global_search	query: str, filters?	在整个保管库中查找备注
obsidian_list_notes	folder?: str	在批量操作之前枚举文件夹中的笔记
obsidian_manage_frontmatter	path: str, op: 'get'\|'set'\|'delete', key?: str, value?: any	原子、钥匙级前置物变化
obsidian_manage_tags	path?: str, op: 'list'\|'add'\|'remove'	标签卫生和分类操作
obsidian_delete_note	path: str	删除备注—永久，不可撤销

成本与限制

运行它的成本

API 配额: 无外部API —本地REST API在您的Mac/PC上运行
每次调用 Token 数: 笔记本大小；典型200–3000
费用: 免费
提示: 首选global_search +按需阅读，而不是将整个文件夹批量列出到上下文中。

安全

权限、密钥、影响范围

凭据存储： 仅限env var中的OBSIDIAN_API_KEY —从未提交。将其视为保管库的本地管理员令牌。

数据出站： 所有流量均为localhost → Obsidian本地REST API。没有来自此服务器的云调用。

本地REST API插件在本地HTTP端口上公开您的保管库；仅绑定到127.0.0.1 ，并仅对本地主机关闭HTTPS。
到达您的OBSIDIAN_API_KEY的攻击者在保管库上获得完整的读/写—如果您怀疑泄漏，请旋转。

故障排查

常见错误与修复

ECONNREFUSED 127.0.0.1: 27123

Obsidian未运行或本地REST API插件已禁用。打开Obsidian并启用插件。

验证： curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/

401未授权

OBSIDIAN_API_KEY与插件的当前密钥不匹配。再次从插件设置中复制值。

验证： Plugin Settings → Local REST API → copy the API key

404在已知文件上

路径是保管库相关的，区分大小写—使用obsidian_list_notes进行确认。

验证： obsidian_list_notes folder='Daily'

替代方案

Obsidian MCP Server 对比其他方案

替代方案	何时用它替代	权衡
obsidian-plugin-skill	您希望Claude帮助创作Obsidian插件，而不是编辑保管库内容	不同的范围
filesystem MCP	您可以进行原始文件操作，不需要黑曜石感知的前置/标记API	您将丢失原子标签/前置物操作

Obsidian MCP Server

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： Obsidian MCP Server

从任何MCP客户将想法记录到今天的每日笔记中

前置条件

步骤

注意事项

将一周的笔记转化为评价文档

前置条件

步骤

整合整个保管库中凌乱的标签

步骤

注意事项

将网页剪辑放入研究收件箱并自动标记

前置条件

步骤

组合

与其他 MCP 搭配，撬动十倍杠杆

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

Obsidian MCP Server 对比其他方案

更多

资源