lstpsche/obsidian-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

42 stars 15 forks 品質 87 トレンド 27MIT

Repository Install

AIエージェントによるローカルObsidianボルト使用のための高速MCPサーバー

概要

AIエージェントがObsidian vaultに完全読み取り/書き込みアクセスできる高性能MCPサーバー。 Rustで書かれています。単一のバイナリとして出荷します。 AI + Obsidian の既存のソリューションは、コミュニティプラグイン(obsidian-local-rest-api)と、MCP のラッパー(mcp-obsidian)で稼働させるための Obsidian アプリが必要です。これは、REST API の exposes にどれが壊れやすく、遅く、制限されます。 obsidian-mcp はファイルシステムに直接話します。ネイティブのObsidianフォーマットを理解しています。wikilinks、frontmatter、タグ、ブロック参照、定期的なメモ、フルグラフ。スタートアップで高速なメモリインディケードを構築し、ファイルシステム・ウォッチャーで同期させます。結果は、Obsidian が開いているか否かを 1 つの依存性のないバイナリです。 MCP クライアント config (Cursor、Claude Desktopなど) に追加して、完了します。19 個のツールがすぐに利用できます。 Metadata と BM25 のインデックスは、ファイルシステムウォッチャーからすぐに更新されます.

概要（AI 翻訳）

AIエージェントがObsidian vaultに完全読み取り/書き込みアクセスできる高性能MCPサーバー。 Rustで書かれています。単一のバイナリとして出荷します。

オブシディアンプラグインはありません。 REST API はありません。従順者無し。ディスクのボルトだけ。

なぜ?

AI + Obsidian の既存のソリューションは、コミュニティプラグイン(obsidian-local-rest-api)と、MCP のラッパー(mcp-obsidian)で稼働させるための Obsidian アプリが必要です。これは、REST API の exposes にどれが壊れやすく、遅く、制限されます。

obsidian-mcp はファイルシステムに直接話します。ネイティブのObsidianフォーマットを理解しています。wikilinks、frontmatter、タグ、ブロック参照、定期的なメモ、フルグラフ。スタートアップで高速なメモリインディケードを構築し、ファイルシステム・ウォッチャーで同期させます。結果は、Obsidian が開いているか否かを 1 つの依存性のないバイナリです。

クイックスタート

MCP クライアント config (Cursor、Claude Desktopなど) に追加して、完了します。19 個のツールがすぐに利用できます。

できること

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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

GitHub で README 全文を見る

インストール

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

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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