Obsidian Index MCP server

简介

Obsidian Index 是一个 MCP 服务器，提供 Obsidian 仓库的语义搜索功能，并将最近的笔记作为资源暴露给 MCP 客户端。

安装

pip install obsidian-index

基本用法

启动服务器：

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

参数说明：

• --vault: Obsidian 仓库路径（可指定多个）
• --database: 数据库文件路径
• --reindex: 重新索引所有笔记
• --watch: 监视仓库变化并更新索引

在 Claude 桌面版中配置

MacOS

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

编辑 %APPDATA%/Claude/claude_desktop_config.json

配置示例

"mcpServers": {
  "obsidian-index": {
    "command": "uvx",
    "args": [
      "obsidian-index",
      "mcp",
      "--vault", "/path/to/your/vault",
      "--database", "/path/to/database.db",
      "--reindex",
      "--watch"
    ]
  }
}

功能

• 资源访问: 通过 obsidian://<VAULT_NAME>/<NOTE_PATH> URL 方案访问笔记
• 语义搜索: 使用 search-notes 工具对索引的笔记执行搜索

调试

使用 MCP Inspector 进行调试：

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

开发

构建与发布：

# 同步依赖
uv sync

# 构建包
uv build

# 发布到 PyPI
uv publish