Obsidian Local REST API

★ 2.635

在 Obsidian 内启动本地 HTTPS 服务器的社区插件——自 2026 年起内置 MCP 端点：可读写笔记、搜索仓库（vault）。

Obsidian Local REST API 是一款社区插件，启动时会在 127.0.0.1:27124 上开启一个本地 HTTPS 服务器（自签名证书；也可额外在 27123 端口启用 HTTP，但需要单独开启）。每个请求都通过 API 密钥进行保护，该密钥可在插件设置中找到，需作为 Bearer token 一并发送。通过 REST 端点可以读取、写入、修补和删除笔记（/vault/{path}）、编辑当前打开的文件（/active/）、进行全文搜索（/search/simple/）、通过 JsonLogic 进行更复杂的元数据搜索（/search/）、列出标签，或触发 Obsidian 命令（/commands/）。

自 2026 年起，该插件额外内置了一个 MCP 端点，位于 /mcp/（采用 Streamable HTTP 传输，认证方式与 REST API 相同），提供 vault_read、vault_write、search_query 等 15 个以上工具。Claude Code 原生支持 HTTP MCP，可通过 CLI 命令直接连接该端点——因此不再需要单独的 MCP 服务器进程。Claude Desktop 不支持原生 HTTP MCP，根据文档需要借助 mcp-remote 之类的桥接工具。这样一来，你自己的 Obsidian 仓库（vault）就变成了一个可供智能体搜索和写入的知识源——一切都在本地机器上完成，数据无需离开本机。

🔧 SETUP

通过 Obsidian 社区插件安装并启用 "Local REST API" 插件
在 Obsidian 中：打开 Settings → Local REST API，复制 API 密钥，必要时信任自签名证书
测试连通性：GET https://127.0.0.1:27124/ 无需认证即可返回状态检查结果
连接 Claude Code：`claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ --header "Authorization: Bearer <your-api-key>"`
或手动写入 `.mcp.json`：`{"mcpServers":{"obsidian":{"type":"http","url":"https://127.0.0.1:27124/mcp/","headers":{"Authorization":"Bearer <your-api-key>"}}}}`

✅ 什么时候用？

编程时搜索笔记

当你正在处理某个模块时，Claude Code 可以在你的 Obsidian 仓库中全文搜索一条旧的架构决策记录。

把结论直接写回

一次调试会话结束后，让 Claude 直接通过 vault_write 把总结写成一条新笔记存入仓库，而无需自己打开 Obsidian。

⛔ 什么时候不该用？

无法远程访问

服务器只在本地 127.0.0.1 上运行——Obsidian 必须在同一台机器上打开对应仓库运行，否则该端点无法访问。

更好的选择: 如需从其他设备访问，可自行搭建隧道/反向代理（不属于插件本身），或直接在存放仓库的那台机器上操作。

Claude Desktop 需要额外步骤

Claude Desktop 不支持原生 HTTP MCP，根据文档需要像 mcp-remote 这样的代理。

更好的选择: 改用 Claude Code（原生支持 HTTP MCP），或配置 mcp-remote 作为桥接。