lstpsche/obsidian-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
로컬 Obsidian vault 사용을 위한 빠른 MCP 서버 AI Agents
개요
고성능 MCP 서버는 Obsidian vaults에 AI 에이전트 전체 읽기 / 쓰기 액세스를 제공합니다. Rust에 글. 단일 바이너리로 배송. AI + Obsidian에 대한 기존 솔루션은 Obsidian 앱이 커뮤니티 플러그인 (obsidian-local-rest-api) 및 MCP 래퍼 (mcp-obsidian)을 최고로 실행해야 합니다. 즉, 느리고, REST API가 노출되는 것을 제한합니다. obsidian-mcp는 filesystem에 직접 이야기합니다. 그것은 기본적으로 Obsidian 형식을 이해 — wikilinks, frontmatter, 태그, 블록 참조, 주기적인 노트, 전체 그래프. 그것은 시작에 빠른 in-memory 인덱스를 구축하고 filesystem watcher를 통해 동기화 유지. 결과는 Obsidian가 열리거나 아닙니다. MCP 클라이언트 구성 (Cursor, Claude Desktop 등)에 추가하면 바로 사용할 수 있습니다. Metadata 및 BM25 지수는 filesystem watcher를 통해 즉시 업데이트됩니다.
개요(AI 번역)
고성능 MCP 서버는 Obsidian vaults에 AI 에이전트 전체 읽기 / 쓰기 액세스를 제공합니다. Rust에 글. 단일 바이너리로 배송.
** Obsidian 플러그인 없음. REST API가 없습니다. Obsidian 실행 없음. 그냥 디스크에 볼트.**
왜?
AI + Obsidian에 대한 기존 솔루션은 Obsidian 앱이 커뮤니티 플러그인 (obsidian-local-rest-api) 및 MCP 래퍼 (mcp-obsidian)을 최고로 실행해야 합니다. 즉, 느리고, REST API가 노출되는 것을 제한합니다.
obsidian-mcp는 filesystem에 직접 이야기합니다. 그것은 기본적으로 Obsidian 형식을 이해 — wikilinks, frontmatter, 태그, 블록 참조, 주기적인 노트, 전체 그래프. 그것은 시작에 빠른 in-memory 인덱스를 구축하고 filesystem watcher를 통해 동기화 유지. 결과는 Obsidian가 열리거나 아닙니다.
빠른 시작
MCP 클라이언트 구성 (Cursor, Claude Desktop 등)에 추가하면 바로 사용할 수 있습니다.
무엇을 할 수 있습니까?
| 분류 | 능력 |
|---|---|
| Navigate | 파일 목록, 나무 전망, vault stats |
| Read & write | 만들기, 읽기, 쓰기, append, prepend, 이동, 메모 삭제 |
이 페이지는 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
설치
npx @modelcontextprotocol/inspector cargo run # interactive testing (stdio)설정
{
"mcpServers": {
"obsidian": {
"command": "obsidian-mcp",
"args": ["/path/to/your/vault"]
}
}
}