Obsidian Notes MCP сервер
MCP сервер, который обеспечивает безопасный прямой доступ к файлам хранилища Obsidian через файловую систему без необходимости запуска приложения Obsidian. Совместим с obsidian.nvim и включает продвинутые возможности поиска, включая обнаружение MOC (карт содержания).
автор: Piotr1215
curl -fsSL https://vibebaza.com/i/obsidian-notes | bashMCP сервер, который обеспечивает безопасный прямой доступ к файлам хранилища Obsidian через файловую систему без необходимости запуска приложения Obsidian. Совместим с obsidian.nvim и включает продвинутые возможности поиска, включая обнаружение MOC (карт содержания).
Установка
Установка через NPM
npm install
Из исходного кода
git clone https://github.com/Piotr1215/mcp-obsidian.git
cd mcp-obsidian
npm install
Конфигурация
Claude Desktop
claude mcp add obsidian -s user -- node /path/to/mcp-obsidian/src/index.js /path/to/your/vault
Тестирование с MCP Inspector
npx @modelcontextprotocol/inspector node src/index.js /home/decoder/dev/obsidian/decoder
Доступные инструменты
| Инструмент | Описание |
|---|---|
search-vault |
Поиск содержимого во всех заметках с логическими операторами, спецификаторами полей, фрагментами контекста... |
search-by-title |
Поиск заметок по их заголовку H1 с быстрым поиском по названию |
list-notes |
Список всех markdown файлов в вашем хранилище или конкретной директории |
read-note |
Чтение полного содержимого конкретной заметки с валидацией пути |
write-note |
Создание или обновление заметки с новым содержимым через атомарную запись |
delete-note |
Удаление заметки из вашего хранилища с безопасным удалением и валидацией |
search-by-tags |
Поиск заметок, содержащих конкретные теги из YAML frontmatter и встроенных #тегов |
get-note-metadata |
Получение метаданных для одной или всех заметок без чтения полного содержимого, извлечение frontmatter, заголовка, тегов... |
discover-mocs |
Обнаружение карт содержания (MOC) для понимания структуры знаний вашего хранилища и обеспечения в 10 раз более быстрой навигации... |
Возможности
- Прямой доступ к хранилищам Obsidian через файловую систему - приложение Obsidian не требуется
- Дизайн с приоритетом безопасности с предотвращением обхода путей и валидацией ввода
- Высокая производительность с отслеживанием времени выполнения и ограничениями ресурсов
- Богатые возможности поиска, включая поддержку regex и поиск по тегам
- Поддержка метаданных с парсингом frontmatter и встроенных тегов
- MCP ресурсы для обнаружения и навигации в стиле HATEOAS
- Обнаружение MOC для картографирования структуры хранилища высокого уровня
- Фрагменты контекста и выделение совпадений в результатах поиска
- Логические операторы поиска (AND, OR, NOT) со спецификаторами полей
- Совместимость с плагином obsidian.nvim
Примеры использования
Search for notes: 'readme AND install'
Find by title or tag: 'title:setup OR tag:documentation'
Exact phrase search: '"getting started" -deprecated'
Complex queries: '(python OR javascript) AND tutorial'
Discover vault structure: 'Show me all Maps of Content in my vault'
Ресурсы
Примечания
Сервер реализует комплексную безопасность с предотвращением обхода путей, ограничениями размера файлов (10MB по умолчанию) и доступом только к markdown файлам. Включает поддержку MCP ресурсов для прямого доступа к заметкам через URI. Обнаружение MOC (карт содержания) обеспечивает в 10 раз более быструю навигацию за счет понимания структуры хранилища. Совместим с настройками, использующими obsidian.nvim без необходимости в приложении Obsidian.