Obsidian Vault MCP Server

Obsidian Vault MCP Server

OleksandrKucherenkoMIT
13 звёзд1 форков
Obsidian Vault MCP Server связывает AI-ассистентов с вашей базой знаний в Obsidian. Сервер использует Local REST API — плагин для Obsidian — чтобы читать, искать и изменять заметки. Вы подключаетесь к хранилищу из любого MCP-клиента и работаете с заметками напрямую, без ручного экспорта.
DevelopmentSearchObsidian
Открыть на GitHubОфициальный сайт

Установка

npx -y @oleksandrkucherenko/mcp-obsidian

Характеристики

Общее

  • СтатусСообщество
  • РазработчикOleksandrKucherenko
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdiostreamable-http

Описание

Возможности

  • Полнотекстовый поиск по содержимому заметок и заголовкам
  • Чтение текста заметки в формате Markdown
  • Создание новых заметок в любом каталоге хранилища
  • Редактирование и обновление существующих записей
  • Удаление заметок, потерявших актуальность
  • Просмотр структуры папок и списка файлов
  • Поиск по тегам и внутренним ссылкам
  • Автоматическая индексация изменений в хранилище

Как подключить

Установите плагин Local REST API в Obsidian. В настройках плагина задайте порт (по умолчанию 27124) и скопируйте API-ключ. Эти данные понадобятся для подключения.

Установка сервера

Выполните команду в терминале:

npx -y @oleksandrkucherenko/mcp-obsidian

Настройка клиента

Добавьте конфигурацию в файл настроек вашего MCP-клиента. Пример для Claude Desktop:

{ "mcpServers": { "obsidian": { "command": "npx", "args": ["-y", "@oleksandrkucherenko/mcp-obsidian"], "env": { "OBSIDIAN_API_KEY": "ваш_api_ключ", "OBSIDIAN_BASE_URL": "http://localhost:27124" } } } }

Завершение настройки

Сохраните файл и перезапустите клиент. В списке доступных инструментов MCP появятся все функции сервера.

Примеры запросов

  • «Найди все заметки, связанные с проектом "Весна 2024", и выпиши ключевые задачи из каждой».
  • «Создай новую заметку в папке "Дневник" с сегодняшней датой и стандартным шаблоном».
  • «Обнови заметку "Список покупок" — добавь в конец пункт "Чай" и удали пункт "Кофе"».
  • «Покажи содержимое заметки "API документация" в формате Markdown».
  • «Удали все заметки в папке "Черновики", которые старше месяца».

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio, streamable-http
  • Лицензия: MIT
  • Установка: npx
  • Совместимость: любой MCP-клиент (Claude Desktop, VS Code)

Поделиться