MCP.so
登录

Obsidian Index MCP server

@tcsavage

基本信息

分类

记忆与知识

传输方式

stdio

作者

tcsavage

关于 Obsidian Index MCP server

MCP server providing sementic search over Obsidian vaults

Obsidian Index MCP server 配置

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

{
  "mcpServers": {
    "mcp-obsidian-index": {
      "command": "uv",
      "args": [
        "run",
        "obsidian-index",
        "mcp",
        "--vault",
        "<VAULT_PATH>",
        "--database",
        "<DATABASE_PATH>",
        "--reindex",
        "--watch"
      ]
    }
  }
}

Obsidian Index MCP server 工具

1

Performs semantic search over indexed notes

概览

What is Obsidian Index MCP server?

Obsidian Index MCP server is an MCP server that provides semantic search over an Obsidian vault and exposes recently modified notes as resources. It is designed for users of Obsidian who want to integrate semantic search and note retrieval into MCP-compatible tools.

How to use Obsidian Index MCP server?

Install via PyPI using uv run obsidian-index or uvx obsidian-index. Launch the server with --vault <VAULT_PATH>, --database <DATABASE_PATH>, --reindex, and --watch flags. The server exposes one tool (search-notes) and the recent notes as resources.

Key features of Obsidian Index MCP server

  • Semantic search over indexed Obsidian vault notes.
  • Exposes recently modified notes as resources.
  • Notes addressed by obsidian:// URL scheme with text/markdown MIME type.
  • Supports multiple vaults via repeated --vault flag.
  • Watches vault changes and updates index automatically with --watch.
  • Reindexes all notes with --reindex flag.

Use cases of Obsidian Index MCP server

  • Quickly find relevant notes in a large Obsidian vault using semantic search.
  • Integrate Obsidian note retrieval into AI assistant contexts (e.g., Claude Desktop).
  • Automatically index and search notes across multiple vaults.
  • Provide recent note context to MCP-compatible clients for enhanced responses.

常见问题

1

What kind of search does it perform?

It performs semantic search over indexed notes in the Obsidian vault.

2

How do I run the server?

Use `uv run obsidian-index mcp --vault <VAULT_PATH> --database <DATABASE_PATH> --reindex --watch` in your terminal.

3

What are the configuration options for Claude Desktop?

Add a JSON entry to `claude_desktop_config.json` using the `uv` or `uvx` command with the appropriate arguments (see Quickstart section in the README).

4

Are there any dependencies?

The server requires Python (with the package installed via `uv`) and the Obsidian Index package itself. No additional runtime dependencies are listed.

5

How can I debug the server?

Use the MCP Inspector: run `npx @modelcontextprotocol/inspector uv --directory <PATH_TO_PROJECT> run obsidian-index`.

评论

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