Obsidian 本地 REST API 插件提供 MCP 服务器,让 AI 客户端直连笔记库
决策简报
Brief- 发生了什么
- Obsidian 插件 obsidian-local-rest-api 通过 HTTPS REST API 和内置 MCP 服务器,让脚本、浏览器扩展和 AI 客户端对笔记库执行读写、精准修改、搜索与事件订阅。
- 为什么重要
- Claude 相关变化会影响 AI 产品团队的技术选型和发布判断。
- 影响谁
- Claude Code · Claude · MCP · Cursor
- 建议动作
- 升级或复核变更版本
- 地区可用性
- 暂未验证地区可用性差异。
关键事实
- Obsidian 插件 obsidian-local-rest-api 通过 HTTPS REST API 和内置 MCP 服务器,让脚本、浏览器扩展和 AI 客户端对笔记库执行读写、精准修改、搜索与事件订阅。 [src-skill-radar]
- 对使用 Obsidian 的开发者来说,这意味着 Claude Code、Cursor 等支持 Streamable HTTP 的 MCP 客户端可以直接读写笔记,不必再自己写一层胶水代码;但 API key 和配置目录的访问控制成了新的需要注意之处。 [src-skill-radar]
由事件证据自动生成。
该插件在本地 127.0.0.1:27124 提供 HTTPS REST API,同时在 /mcp/ 路径内置 MCP 服务器,两者暴露相同的核心能力:对笔记库任意文件的增删改查、针对标题/块引用/frontmatter 键的局部 patch、全文搜索与 JsonLogic 结构化查询、事件流订阅、列执行 Obsidian 命令和查询标签。所有请求需 API key 认证,插件首次运行会自建受名称约束的证书授权中心,只对 127.0.0.1、localhost 等指定主机名生效,避免被用于冒充其他站点。 对接方式按客户端区分:Claude Code 原生支持 HTTP MCP,可用一条 CLI 命令添加;Cursor 支持 Streamable HTTP,写入 mcp.json 即可;Claude Desktop 不支持远程 HTTP MCP,需借助 mcp-remote 桥接(依赖 Node.js)。 安全细节上有几处硬性约束:API 拒绝读写 .obsidian 配置目录(含存储 API key 的 data.json),因为写入该目录等同于远程执行代码;同一来源一分钟内十次错误凭据会被 429 限流,而携带正确 key 的请求不受影响;写入支持 If-Match/If-None-Match 条件写,避免两个客户端同时改同一笔记时互相覆盖。对用 Obsidian 做知识库管理、又想让 AI 代理直接操作笔记的开发者,这几条直接决定了能否安全接入。
来源
- Skill Radar(GitHub 趋势)
Trending hands-on MCP servers, agent skills, and AI-coding tools discovered from GitHub search momentum.
- GitHub:coddingtonbear/obsidian-local-rest-api
留言
登入后即可留言,和其他 builder 交换实测心得。
还没有留言,抢头香。