Obsidian Index Service MCP Server

@pmmvr

代码仓库

基本信息

分类

记忆与知识

许可证

MIT

传输方式

stdio

作者

pmmvr

关于 Obsidian Index Service MCP Server

A service that monitors an Obsidian vault for file changes (new, modified, or deleted Markdown files) and indexes each note’s metadata and content into an SQLite database, exposing it for e.g. an MCP-server

#obsidian #indexing #markdown #sqlite #note-management

Obsidian Index Service MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "obsidian-index-service": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Obsidian Index Service MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Obsidian Index Service?

Obsidian Index Service monitors an Obsidian vault directory and indexes Markdown files—metadata and full content—into an SQLite database. It tracks file changes (create, modify, delete) and stores path, title, tags, timestamps, content, and processing status. It is intended as an agnostic note indexer and potential sync tool.

How to use Obsidian Index Service?

Set environment variables OBSIDIAN_VAULT_PATH and DB_PATH, or pass --vault-path and --db-path command-line options. Run locally with python main.py or uv run python main.py. Use --scan-only for a one-time scan. For Docker, run docker-compose up -d to mount the vault and expose the database.

Key features of Obsidian Index Service

Monitors Obsidian vault for file changes (create, modify, delete)
Indexes metadata: path, title, parent folders, tags, dates
Stores full Markdown content in SQLite
Supports Docker deployment with persistent volume
WAL mode for concurrent read access by other services
Graceful shutdown on termination signals

Use cases of Obsidian Index Service

Indexing an Obsidian vault for external search or analytics
Providing a read-only SQLite database for other services (e.g., an MCP server) to query note metadata
Synchronizing vault changes to a remote backend (future direction)
One-time scan to snapshot vault contents

常见问题

What are the prerequisites?

Python 3.12 or later, Docker and Docker Compose (for containerized use), and optionally `uv`.

Where does the indexed data live?

Data is stored in an SQLite database at the path specified by `DB_PATH` (default `/data/notes.sqlite` in Docker). The database is mounted as a Docker volume.

How does it handle concurrent access from other services?

SQLite is run in Write-Ahead Logging (WAL) mode. Other services can mount the same volume read-only (e.g., `/data:ro`) and safely query the database while Obsidian Index Service writes to it.

Does it support continuous monitoring or only one-time scan?

By default it watches the vault continuously; use `--scan-only` to index once and exit.

What metadata fields are captured?

Path (unique identifier), title (from filename), parent folders (relative to vault root), tags (from YAML frontmatter), created/modified timestamps, full content, processing status, and error message if processing fails.

记忆与知识分类下的更多 MCP 服务器

Neither MCP

stonianua

Project context your AI can query through MCP — with source evidence.

Agimem

Persistent memory for AI agents. Hosted MCP server with capsule-scoped key/value storage, tags, TTL expiration, bulk ops, and RBAC.

Context7 MCP - Up-to-date Docs For Any Cursor Prompt

upstash

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

58.7K

M1K3

Round-Tower

Local AI agent for your Mac with a built-in MCP server: 18 tools for your notes and PDFs, a temporal memory graph, an on-device LLM and a neural voice. No account, no telemetry. No data centers required.

ctxfile

Local-first MCP server that snapshots your project's working state into one context object. Open-core, privacy-first.