
你的Obsidian vault,暴露给Claude和任何MCP客户端。运行在Obsidian内部,设备内语义搜索,无云往返,无二进制下载。
概览
你的Obsidian vault,通过模型上下文协议向AI客户端开放。MCP服务器运行于回环状态,无需二进制下载,也无云端往返。Claude Desktop、Claude Code、Cursor、Cline、Continue、Windsurf和VS Code都连接到同一个端点。 - 服务器仅绑定回环。Vault 的读写通过 Obsidian 自有的 app.vault 和 app.metadataCache API,因此 Obsidian 的权限模型仍然适用。- 服务器是运行于 Obsidian 渲染器中的插件代码,这消除了下载和执行预构建可执行文件的供应链表面。- Transformers.js 本地运行嵌入模型。没有 API 密钥,也不需要 Smart Connections 要求。- 传输不保留会话状态,这正是实现每个客户端工具表面的原因。 2.0版本是该连接器不再等待下一个MCP版本,而是开始为其服务的版本。
概述(AI 翻译)
[!警告] 已知问题:在Obsidian 1.14.4中,这个插件加载时窗口可能会变空白。 这影响macOS和Windows,是Obsidian渲染器在Electron 43内部崩溃,不是该插件代码。在我的测试中,大约每十个插件加载中随机出现一次。重启Obsidian并重新启用插件:通常有效。我在Electron 39.8.3(Obsidian安装程序1.12.7)上没有看到崩溃,所以我认为原因出在Obsidian 1.14.4自带的Electron和V8版本。我还没有插件端的解决办法。我在Obsidian论坛上举报了,记录在#597和#609。
你的Obsidian保险库,通过模型上下文协议向AI客户端开放。MCP服务器运行于Obsidian内部,采用回环,无需下载二进制文件,也无需云往返。Claude Desktop、Claude Code、Cursor、Cline、Continue、Windsurf和VS Code都连接到同一端点。
3.0.0 版本的新内容 ·快速启动 ·工具 ·渲染搜索结果 ·自适应工具加载 ·每个客户端的标记 ·提示词 ·协议 ·客户端 ·故障排除 ·安全性 ·开发者用
它是如何运作的
客户端配置指向 127.0.0.1:27200 上的共享代理。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
MCP Connector for Obsidian
[!NOTE] Blank window on Obsidian 1.14 (Electron 43): fixed in 3.1.1. If Obsidian’s window went white while this plugin loaded, update to 3.1.1 or later. Both causes were in the plugin. Read with Electron’s own symbol files, the crash reports hold two signatures. The first is V8 stopping inside a read of Node’s
AsyncLocalStorage: Node 24 (Electron 40 and later) keeps its frames in a V8 slot that Chromium also writes to, and 3.1.0 no longer uses it inside Obsidian. The second is V8 running out of JavaScript heap: every reload of the plugin kept the previous instance in memory, about 40 MB each, through a$arkglobal that the plugin’s schema library registers and never removes, and 3.1.1 removes it at unload. On one Mac, toggling the plugin off and on: 3.0.3 crashed on the first reload and 3.1.0-alpha.2 once in 200 (Obsidian 1.14.5, Electron 43.8.3), 3.1.1 never in 420 (Obsidian 1.15.0, Electron 43.8.3). The reporter of #597 confirmed it on Obsidian 1.14.4 with 3.1.1 and closed the issue. #609 stays open until its reporter confirms. Details in ADR-0032 and on the Obsidian forum.
Your Obsidian vault, exposed to AI clients over the Model Context Protocol. The MCP server runs inside Obsidian, on loopback, with no binary to download and no cloud round-trip. Claude Desktop, Claude Code, Cursor, Cline, Continue, Windsurf and VS Code all connect to the same endpoint.
安装
npx -y mcp-remote http://127.0.0.1:27200/v1/<route-id>/mcp --header Authorization: Bearer YOUR_TOKEN配置
{
"mcpServers": {
"obsidian_my_vault": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://127.0.0.1:27200/v1/<route-id>/mcp",
"--header", "Authorization: Bearer YOUR_TOKEN"]
}
}
}