Obsidian Index MCP 服务器

MCP 服务器提供对 Obsidian 保险库的语义搜索，并将最近的注释作为资源公开。

成分

资源

服务器将您保险库中最近修改的注释作为资源公开给 MCP 客户端。

注释通过obsidian://<VAULT_NAME>/<NOTE_PATH> URL 方案进行寻址
笔记具有text/markdown媒体类型

工具

服务器实现了一个工具：

search-notes ：对索引注释执行语义搜索

运行服务器

uv run obsidian-index mcp --vault <VAULT_PATH> --database <DATABASE_PATH> --reindex --watch

--vault ：黑曜石保险库的路径（可以多次指定）
--database ：本地数据库文件的路径（如果不存在则创建）
--reindex ：重新索引保管库中的所有笔记（您现在可能每次都需要这样做）
--watch ：监视保险库中的变化并相应地更新索引

快速入门

安装

克劳德桌面

在 MacOS 上： ~/Library/Application\ Support/Claude/claude_desktop_config.json在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

发展

构建和发布

准备分发包：

同步依赖项并更新锁文件：

uv sync

构建软件包分发版：

uv build

这将在dist/目录中创建源和轮子分布。

发布到 PyPI：

uv publish

注意：您需要通过环境变量或命令标志设置 PyPI 凭据：

令牌： --token或UV_PUBLISH_TOKEN
或用户名/密码： --username / UV_PUBLISH_USERNAME和--password / UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 运行，调试起来可能比较困难。为了获得最佳调试体验，我们强烈建议使用MCP Inspector 。

您可以使用以下命令通过npm启动 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory <PATH_TO_PROJECT> run obsidian-index

启动后，检查器将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

This server cannot be installed

security - not tested

license - not found

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

提供对 Obsidian 保险库的语义搜索功能，并通过 MCP 协议将最近的笔记作为资源公开给 Claude。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Obsidian
smithery-ai
-
security
A
license
-
quality
This is a connector to allow Claude Desktop (or any MCP client) to read and search any directory containing Markdown notes (such as an Obsidian vault).
Last updated -
1,530
718
JavaScript
AGPL 3.0
@kazuph/mcp-obsidian
kazuph
A
security
A
license
A
quality
Obsidian vault connector for Claude Desktop - enables reading and writing Markdown notes using Model Context Protocol (MCP)
Last updated -
4
36
3
JavaScript
MIT License
MCP Tools for Obsidian
jacksteamdev
-
security
A
license
-
quality
A local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.
Last updated -
60
TypeScript
MIT License
Obsidian Omnisearch MCP Server
anpigon
-
security
A
license
-
quality
Provides programmatic search functionality for Obsidian vaults through a REST API interface, allowing external applications to search through notes and retrieve absolute paths to matching documents.
Last updated -
10
Python
MIT License

View all related MCP servers

Obsidian Index MCP Server