N0

newtype-01/obsidian-mcp

Developer tools

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

308 stars 49 forks Качество 66 Тренд 19MIT

newtype-01/obsidian-mcp — это кандидат-сервер MCP, импортированный из https://github.com/newtype-01/obsidian-mcp.

Обзор

newtype-01/obsidian-mcp — это кандидат-сервер MCP, импортированный из https://github.com/newtype-01/obsidian-mcp.

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

Английский | 中文

Этот проект реализует сервер Model Context Protocol (MCP) для соединения моделей ИИ с базами знаний Obsidian. Через этот сервер модели ИИ могут напрямую получать доступ и управлять заметками Obsidian, включая чтение, создание, обновление и удаление заметок, а также управление структурой папок.

Создано huangyihe

Особенности

  • ** 🔗 Бесшовная интеграция Obsidian**: Прямой доступ к базам знаний Obsidian через протокол MCP
  • ** 📝 Полное управление заметками**: Чтение, создание, обновление и удаление заметок с расширенной заменой текста
  • ** 📁 Операции с папками**: Создавать, переименовывать, перемещать и удалять папки с полной иерархией
  • ** 🔍 Интеллектуальный поиск**: полнотекстовый поиск по всем типам файлов с умной оценкой
  • ** 🤖 Анализ на основе искусственного интеллекта**: НОВИНКИ Стратегические инсайты с использованием рамки TRILEMMA-PRINCIPLES
  • ** 🔗 Автоматическая генерация обратных ссылок**: НОВОЕ Интеллектуальное обнаружение и преобразование имён нот в викиссылки
  • ** ⚡ Точное редактирование**: Продвинутые операции PATCH с наведением курса и уровней блока

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

README

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

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

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
Открыть полный README на GitHub

Установка

npx @huangyihe/obsidian-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "mcpServers": { "obsidian-mcp": { "command": "npx", "args": [ "@huangyihe/obsidian-mcp" ], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/vault", "OBSIDIAN_API_TOKEN": "your_api_token", "OBSIDIAN_API_PORT": "27123" } } } }