obsidian-mcp-connector 是什么？

MCP Connector 让 Claude Desktop、Claude Code、Cursor、VS Code 等 AI 应用安全访问你的 Obsidian 笔记库。插件在 Obsidian 内部托管 MCP 服务器，语义搜索完全在本机运行。

obsidian-mcp-connector 是开源的吗？

是的，采用 MIT 许可证。

obsidian-mcp-connector

Q: obsidian-mcp-connector 是开源的吗？

是的，采用 MIT 许可证。

活跃·★ 119·MIT·更新于 2026-10-26

MCP Connector for Obsidian 让 Claude Desktop、Claude Code、Cursor、Cline、Continue、Windsurf 和 VS Code 等 AI 应用通过 Model Context Protocol 使用 Obsidian 知识库。自 0.4.0 版本起，插件在 Obsidian 内部进程里运行 MCP 服务，并在 127.0.0.1:27200 提供 Streamable HTTP。README 强调仓库不再提供原生二进制文件，从而避免了下载并运行平台相关可执行文件带来的供应链风险。

原生支持 HTTP 的客户端可以直接连接；只支持 stdio 的 Claude Desktop 则通过官方 npx mcp-remote 桥接，插件会生成两行配置。工具覆盖用带类型的工具读取、写入和修补笔记、周期性笔记、图谱导航、纯文本搜索和 Dataview 查询。语义搜索使用 Transformers.js 在本机运行，默认模型约 25 MB 的 all-MiniLM-L6-v2，也可选 Gemma 300M、Multilingual-E5-Base 和 Smart Connections。Local REST API 插件是可选的，只有 search_vault 工具需要它。

#Claude#MCP 协议#MCP 服务器#模型上下文协议#Obsidian 插件

功能特性

01通过带类型的工具读取、写入和修改笔记

02完全在本机运行的语义搜索，无需云服务

03在 127.0.0.1 提供 Streamable HTTP 端点；Claude Desktop 通过 mcp-remote 连接

为什么选择它

+在 Obsidian 内部运行，不需要单独的服务二进制文件，降低供应链风险。

+HTTP 客户端可直接连接，Claude Desktop 通过生成的 mcp-remote 配置接入。

+本机语义搜索，支持多种嵌入模型，包括适合非拉丁文字知识库的选项。

+支持每日和周期性笔记、局部读取、Dataview 查询和带类型的笔记修补。

权衡点

!服务运行在 Obsidian 插件内部，所以只有 Obsidian 在运行时才可用。

!Claude Desktop 只支持 stdio，需要额外的 npx mcp-remote 桥接。

!用于 Dataview DQL 和 JsonLogic 查询的 search_vault 工具仍需要 Local REST API 插件，嵌入模型也要在首次使用时下载。

维护状况检查

活跃检查日期: 2026-10-24

最近提交: 2026-10-24
近 90 天提交数: 100+
近 90 天发布数: 30
最新发布: 3.2.0 (2026-10-24)
未关闭 issue: 6
近期 issue 至少有一条评论的比例: 8/13

近 12 周每周提交数

最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。

状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

#597 [BUG] Renderer crash (white window) with Obsidian 1.14.4 / Electron 43 when the plugin loads, macOS and Windows18 条评论 · 2026-10-08
#609 [BUG] Obsidian 1.14.4 goes completely white when enabling MCP Connector 3.0.29 条评论 · 2026-10-14
#630 Move non-essential work off the plugin load path (store migration, sidecar probes)1 条评论 · 2026-10-17
#629 Startup cost: defer arktype compile, lazy-load the ML stack, compress the embedded app HTML1 条评论 · 2026-10-17
#610 [FEATURE] support for EmbeddingGemma 21 条评论 · 2026-10-15

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

兼容性

Claude Code

客户端

已通过文档验证

Claude Desktop

客户端

已通过文档验证

Cursor

编辑器

已通过文档验证

Windsurf

编辑器

已通过文档验证

VS Code

编辑器

已通过文档验证

Cline

扩展插件

已通过文档验证

快速开始

$ git clone https://github.com/istefox/obsidian-mcp-connector.git

使用场景

↳用 AI 助手搜索并整理 Obsidian 笔记库

↳从 MCP 客户端运行 Templater 提示

obsidian-mcp-connector

活跃·★ 119·MIT·更新于 2026-10-26

#Claude#MCP 协议#MCP 服务器#模型上下文协议#Obsidian 插件

功能特性

01通过带类型的工具读取、写入和修改笔记

02完全在本机运行的语义搜索，无需云服务

03在 127.0.0.1 提供 Streamable HTTP 端点；Claude Desktop 通过 mcp-remote 连接

为什么选择它

+在 Obsidian 内部运行，不需要单独的服务二进制文件，降低供应链风险。

+HTTP 客户端可直接连接，Claude Desktop 通过生成的 mcp-remote 配置接入。

+本机语义搜索，支持多种嵌入模型，包括适合非拉丁文字知识库的选项。

+支持每日和周期性笔记、局部读取、Dataview 查询和带类型的笔记修补。

权衡点

!服务运行在 Obsidian 插件内部，所以只有 Obsidian 在运行时才可用。

!Claude Desktop 只支持 stdio，需要额外的 npx mcp-remote 桥接。

!用于 Dataview DQL 和 JsonLogic 查询的 search_vault 工具仍需要 Local REST API 插件，嵌入模型也要在首次使用时下载。

维护状况检查

活跃检查日期: 2026-10-24

最近提交: 2026-10-24
近 90 天提交数: 100+
近 90 天发布数: 30
最新发布: 3.2.0 (2026-10-24)
未关闭 issue: 6
近期 issue 至少有一条评论的比例: 8/13

近 12 周每周提交数

最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。

状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

#597 [BUG] Renderer crash (white window) with Obsidian 1.14.4 / Electron 43 when the plugin loads, macOS and Windows18 条评论 · 2026-10-08
#609 [BUG] Obsidian 1.14.4 goes completely white when enabling MCP Connector 3.0.29 条评论 · 2026-10-14
#630 Move non-essential work off the plugin load path (store migration, sidecar probes)1 条评论 · 2026-10-17
#629 Startup cost: defer arktype compile, lazy-load the ML stack, compress the embedded app HTML1 条评论 · 2026-10-17
#610 [FEATURE] support for EmbeddingGemma 21 条评论 · 2026-10-15

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

兼容性

Claude Code

客户端

已通过文档验证

Claude Desktop

客户端

已通过文档验证

Cursor

编辑器

已通过文档验证

Windsurf

编辑器

已通过文档验证

VS Code

编辑器

已通过文档验证

Cline

扩展插件

已通过文档验证

快速开始

$ git clone https://github.com/istefox/obsidian-mcp-connector.git

使用场景

↳用 AI 助手搜索并整理 Obsidian 笔记库

↳从 MCP 客户端运行 Templater 提示

obsidian-mcp-connector

功能特性

为什么选择它

权衡点

维护状况检查

讨论最多的未关闭 issue

兼容性

快速开始

使用场景

同类工具

评论

obsidian-mcp-connector

功能特性

为什么选择它

权衡点

维护状况检查

讨论最多的未关闭 issue

兼容性

快速开始

使用场景

同类工具

评论