lstpsche/obsidian-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

42 stars 15 forks Качество 87 Тренд 27MIT

Repository Install

Быстрый MCP-сервер для локального использования хранилища Obsidian агентами AI

Обзор

Высокопроизводительный MCP-сервер, предоставляющий агентам ИИ полный доступ к чтению/записи в хранилищах Obsidian. Написано в ржавчине. Корабли как единая двоичная система. Существующие решения для AI + Obsidian требуют, чтобы приложение Obsidian работало с плагином сообщества (obsidian-local-rest-api) и оберткой MCP (mcp-obsidian). Это хрупко, медленно и ограничено тем, что раскрывает REST API. obsidian-mcp обращается непосредственно к файловой системе. Он понимает формат Obsidian изначально — вики-ссылки, фронтматер, теги, ссылки на блоки, периодические заметки, полный граф. Он создает быстрые индексы в памяти при запуске и синхронизирует их с помощью файловой системы. Результатом является единая двоичная система, которая работает независимо от того, открыт ли Obsidian или нет. Добавьте конфигурацию клиента MCP (Cursor, Claude Desktop и т. д.), и вы закончите — 19 инструментов доступны сразу. Метаданные и индексы BM25 обновляются непосредственно через файловую систему.

Обзор (машинный перевод)

** Без плагинов Obsidian. Нет REST API. Никакого обсидиана. Только ваше хранилище на диске. **

##Почему?

Существующие решения для AI + Obsidian требуют, чтобы приложение Obsidian работало с плагином сообщества (obsidian-local-rest-api) и оберткой MCP (mcp-obsidian). Это хрупко, медленно и ограничено тем, что раскрывает REST API.

obsidian-mcp обращается непосредственно к файловой системе. Он понимает формат Obsidian изначально — вики-ссылки, фронтматер, теги, ссылки на блоки, периодические заметки, полный граф. Он создает быстрые индексы в памяти при запуске и синхронизирует их с помощью файловой системы. Результатом является единая двоичная система, которая работает независимо от того, открыт ли Obsidian или нет.

Быстрый старт

Добавьте конфигурацию клиента MCP (Cursor, Claude Desktop и т. д.), и вы закончите — 19 инструментов доступны сразу.

Что можно сделать

| Категория | Возможности

Navigate | Файлы списка, вид дерева, статистика хранилища | Читать и писать | Создавать, читать, перезаписывать, добавлять, готовить, перемещать, удалять примечания |

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

obsidian-mcp

A high-performance MCP server that gives AI agents full read/write access to Obsidian vaults. Written in Rust. Ships as a single binary.

No Obsidian plugins. No REST API. No Obsidian running. Just your vault on disk.

Why?

Existing solutions for AI + Obsidian require the Obsidian app to be running with a community plugin (obsidian-local-rest-api) and an MCP wrapper (mcp-obsidian) on top. That’s fragile, slow, and limited to what the REST API exposes.

obsidian-mcp talks directly to the filesystem. It understands the Obsidian format natively — wikilinks, frontmatter, tags, block references, periodic notes, the full graph. It builds fast in-memory indices on startup and keeps them synced via a filesystem watcher. The result is a single dependency-free binary that works whether Obsidian is open or not.

Quick Start

# Install
cargo install obsidian-mcp

# Run (stdio — for MCP clients that launch the process)
obsidian-mcp /path/to/your/vault

# Run (HTTP — shared server for multiple agents)
obsidian-mcp --http /path/to/your/vault

Add to your MCP client config (Cursor, Claude Desktop, etc.) and you’re done — 19 tools are available immediately.

What It Can Do

Category	Capabilities
Navigate	List files, tree view, vault stats
Read & write	Create, read, overwrite, append, prepend, move, delete notes
Patch	Edit individual heading sections, block references, or frontmatter fields without touching the rest of the note
Search	BM25 full-text (Tantivy) with stemming, fuzzy matching, and per-field filtering. Semantic search via managed local or API embeddings. Regex. Tag and frontmatter queries.
Graph	Backlinks, outgoing links, broken link detection, orphan discovery
Frontmatter	Get/set/remove fields, query notes by metadata
Periodic notes	Daily, weekly, monthly, quarterly, yearly — with Obsidian-compatible date formats and template expansion

Metadata and BM25 indices update immediately through the filesystem watcher. Embeddings reconcile asynchronously through a managed background runtime, so model loading, inference, and cache writes never delay MCP startup or core tools.

Installation

From crates.io

cargo install obsidian-mcp

For semantic search local compatibility mode (OBSIDIAN_SEMANTIC_MODE=local), build with embeddings:

cargo install obsidian-mcp --features embeddings

Открыть полный README на GitHub

Установка

npx @modelcontextprotocol/inspector cargo run # interactive testing (stdio)

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp",
      "args": ["/path/to/your/vault"]
    }
  }
}