영어 | 中文

이 프로젝트는 AI 모델을 Obsidian 지식 기반과 연결하는 모델 컨텍스트 프로토콜(MCP) 서버를 구현합니다. 이 서버를 통해 AI 모델은 Obsidian 노트에 직접 접근하고 조작하며, 노트를 읽고, 생성하며, 업데이트하고, 삭제하고, 폴더 구조를 관리할 수 있습니다.

호황이허가 창조

• 프롬프트 하우스: https://prompthouse.app/
• 유튜브: https://www.youtube.com/@huanyihe777
• 트위터: https://x.com/huangyihe
• 커뮤니티: https://t.zsxq.com/19IaNz5wK

특징

• ** 🔗 원활한 옵시디언 통합**: MCP 프로토콜을 통한 옵시디언 지식 베이스에 직접 접근
• ** 📝 완전한 노트 관리**: 고급 텍스트 대체로 노트를 읽고, 생성하며, 업데이트하고 삭제할 수 있습니다.
• ** 📁 폴더 작업**: 전체 계층 지원 폴더 생성, 이름 변경, 이동 및 삭제
• ** 🔍 지능형 검색**: 모든 파일 유형에 대한 전체 텍스트 검색과 스마트 점수 분석
• ** 🤖 AI 기반 분석**: 새롭습니다 TRILEMMA-PRINCIPLES 프레임워크를 활용한 전략적 통찰
• ** 🔗 자동 백링크 생성**: 새롭습니다 노트 이름을 위키링크로 지능형 감지 및 변환
• ** ⚡ 정밀 편집**: 방향 및 블록 단위 타겟팅을 포함한 고급 PATCH 작업

Obsidian MCP (Model Context Protocol) Server

English | 中文

This project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.

Created by huangyihe

• Prompt House: https://prompthouse.app/
• YouTube: https://www.youtube.com/@huanyihe777
• Twitter: https://x.com/huangyihe
• Community: https://t.zsxq.com/19IaNz5wK

Features

• 🔗 Seamless Obsidian Integration: Direct access to Obsidian knowledge bases through MCP protocol
• 📝 Complete Note Management: Read, create, update, and delete notes with advanced text replacement
• 📁 Folder Operations: Create, rename, move, and delete folders with full hierarchy support
• 🔍 Intelligent Search: Full-text search across all file types with smart scoring
• 🤖 AI-Powered Analysis: NEW Strategic insights using TRILEMMA-PRINCIPLES framework
• 🔗 Auto Backlink Generation: NEW Intelligent detection and conversion of note names to wikilinks
• ⚡ Precision Editing: Advanced PATCH operations with heading and block-level targeting
• 🚀 Dual API Strategy: Obsidian REST API with filesystem fallback for maximum reliability
• 🎯 Context Optimization: Smart content summarization for LLM context length management
• 📊 Batch Processing: Efficient bulk operations with progress tracking

Supported Tools

The MCP server provides the following comprehensive tools:

📋 Core Operations

• list_notes: List notes in the Obsidian vault with optional folder filtering
  • NEW recursive parameter: Control whether to list files recursively in subdirectories (default: true)
  • Use recursive: false to list only files in the specified folder without subdirectories
• read_note: Read the content of a specific note in the Obsidian vault
• read_multiple_notes: Read content from multiple notes simultaneously for batch processing
• create_note: Create a new note in the Obsidian vault with full content
• delete_note: Delete a note from the Obsidian vault
• search_vault: Advanced search across all file types with filename and content matching
• move_note: Move or rename notes to new locations (supports all file types including PDFs)
• manage_folder: Complete folder CRUD operations (create/rename/move/delete)

🚀 Advanced Features

• update_note: Enhanced Update content using text replacements OR precision insertion

  • Traditional text replacement mode
  • NEW Heading-based insertion (before/after/append/prepend)
  • NEW Block ID-based insertion with ^block-id support
  • NEW PATCH API integration with filesystem fallback

• auto_backlink_vault: 🔗 Auto Backlink Generation

  • Intelligently scan entire vault for note name mentions