用途:已连接的 obsidian MCP 服务器只暴露 Obsidian Local REST API(插件 obsidian-local-rest-api)的部分能力,本技能提供完整 API 接口与带认证的请求包装,让缺失的 MCP 方法改走 HTTP,而无需用删除再重建等变通手段。
适用场景:优先使用 mcp__obsidian__* 工具完成读取、追加、修补、删除与搜索;仅当无对应 MCP 工具时才回退到本技能,包括重命名/移动笔记(保留历史并更新内部链接)、用 PUT 原子覆盖整个文件、操作界面中当前打开的 active 文件、执行命令面板命令、在 UI 中打开/聚焦笔记、列出全部仓库标签及数量、创建更新删除日期类周期性笔记。
主要能力与用法:从已连接的 obsidian MCP 配置(~/.claude.json)或 OBSIDIAN_* 环境变量解析主机、端口与密钥,不硬编码密钥;处理插件自签名 TLS 证书;覆盖 Local REST API 全部端点,含头部枚举 Operation、Target-Type、Target-Scope,自定义 MOVE 约定与搜索(JsonLogic/Dataview)格式。调用包装脚本 scripts/olrapi.sh <METHOD> <path> [curl args...],例如: $S MOVE "/vault/Path/To/Old Name.md" -H 'Destination: Path/To/New Name.md' $S MOVE "/vault/Inbox/todo.md" -H 'Destination: Archive/' $S PUT "/vault/Path/Note.md" -H 'Content-Type: text/markdown' --data-binary @/tmp/body.md $S GET "/vault/Path/Note.md" -H 'Accept: application/vnd.olrapi.note+json' $S GET /tags/ $S POST "/commands/editor:toggle-bold/" $S POST "/open/Path/Note.md?newLeaf=true" 包装器在响应体后打印 <<HTTP nnn>>,成功为 200/204;MOVE 返回 409 表示目标已存在,可加 -H 'Allow-Overwrite: true' 强制覆盖;复杂调用需查阅 references/api_reference.md。
路径与编码规则:{filename} 为仓库相对路径,仓库路径不加前导斜杠;URL 路径与 MOVE 的 Destination 头中的非 ASCII 需百分号编码(如 r%C3%A9sum%C3%A9.md);Destination 拒绝绝对路径(/…);可用 Target-Type(heading|block|frontmatter)针对笔记的局部内容,Target 头用于 GET/PATCH/POST。API 在 27124 端口提供 HTTPS(自签名,用 curl -k),在 27123 提供 HTTP。可用 scripts/olrapi.sh GET /openapi.yaml 对照当前插件重新生成参考,GET / 查看插件版本。
限制:资料未提供该技能的收费、价格、平台支持范围、效果数据及更多边界条件,暂未提供。