MCP-сервер Second Brain

MCP-сервер с доступом только для чтения для интеллектуального и безопасного взаимодействия с вашим хранилищем Obsidian, обеспечивающий семантический поиск, фильтрацию по метаданным и многое другое для LLM.

Возможности

• Эффективное хранение в базе данных: индексация на основе SQLite для больших хранилищ с постоянным кэшированием

• Режим памяти: опциональная индексация в оперативной памяти для небольших хранилищ или разработки

• Семантический поиск: полнотекстовый поиск по всем заметкам с нечетким сопоставлением

• Фильтрация по тегам: поиск по иерархическим тегам (например, work/puppet, tech/golang)

• Фильтрация по путям: фильтрация по шаблонам каталогов (например, Work/Puppet/**)

• Временные запросы: фильтрация заметок по датам создания/изменения

• Фильтрация по метаданным: фильтрация по типу, статусу и категории

• Извлечение заметок: получение полного содержимого конкретных заметок

• Умное обобщение: создание сводок по коллекциям заметок

• Недавние заметки: быстрый доступ к недавно измененным заметкам

• Управление архивом: возможность включения архивных заметок в поиск

• Пробелы в знаниях: обнаружение осиротевших вики-ссылок и открытых вопросов по всему хранилищу

• Интервальное повторение: отображение устаревших заметок, ранжированных по важности ссылок, для периодического просмотра

• Связанные заметки: обнаружение связанных заметок на основе оценок через общие ссылки, теги и совпадения в заголовках

• Граф хранилища: полный граф ссылок с обнаружением хабов, статистикой битых ссылок и анализом осиротевших заметок

• Безопасность: защита от обхода путей, ограничения размера файлов, проверка входных данных

Совместимость с хранилищами

Этот сервер работает с любым каталогом Markdown-файлов, а не только с хранилищами Obsidian. Он работает исключительно на уровне файловой системы и не зависит от приложения Obsidian.

Использование с Foam

Укажите --vault-path на корень вашего рабочего пространства Foam. Изменения конфигурации не требуются:

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/foam-workspace"

Функции Foam, которые работают «из коробки»:

• [[wikilinks]] и [[target|aliased links]] разрешаются в инструментах графа

• Теги YAML frontmatter (как встроенные [tag1, tag2], так и в стиле списка блоков)

• Иерархии вложенных тегов (work/backend)

• Структура подпапок (notes/, journal/, projects/)

• Заметки без frontmatter индексируются с безопасными значениями по умолчанию

Папка .vscode/ автоматически исключается из индексации.

Дизайн «только для чтения»

Этот MCP-сервер намеренно является только для чтения, чтобы гарантировать безопасность вашего хранилища во время взаимодействия с ИИ. Он обеспечивает:

• ✅ Поиск и извлечение заметок

• ✅ Фильтрацию по метаданным и путям

• ✅ Создание сводок и статистики

• ❌ Никакого создания или редактирования заметок

• ❌ Никаких модификаций файлов

Для операций записи рассмотрите возможность использования специализированных плагинов Obsidian со встроенными проверками безопасности.

Установка

Конфигурация и установка

Установка в один клик

• VS Code:

• VS Code Insiders:

• Cursor:

Ручная установка

Установка не требуется! Используйте напрямую с npx:

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Локальная разработка

cd second-brain-mcp
npm install
npm run build
npm link

Это делает сервер доступным глобально как second-brain-mcp.

Claude Code и Claude Desktop

Claude Code

Добавьте сервер, используя:

claude mcp add second-brain -- npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Claude Desktop

Добавьте в файл конфигурации Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/path/to/your/vault"
      ]
    }
  }
}

См. docs/configuration.md для получения информации о структуре хранилища, аргументах CLI и примерах конфигурации.

См. docs/api.md для получения полной справочной информации по API MCP и примеров использования.

Использование с Claude Code

Добавьте в ваш файл конфигурации MCP.

Конфигурация одного хранилища

macOS/Linux: Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json Windows: Отредактируйте %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/ioanniskarasavvaidis/Documents/Obsidian Vault"
      ]
    }
  }
}

Конфигурация нескольких хранилищ

Вы можете настроить несколько экземпляров хранилищ:

{
  "mcpServers": {
    "second-brain-personal": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Personal Vault"
      ]
    },
    "second-brain-work": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Work Vault"
      ]
    }
  }
}

Настройка локальной разработки

Если вы разрабатываете локально с помощью npm link:

{
  "mcpServers": {
    "second-brain": {
      "command": "second-brain-mcp",
      "args": ["--vault-path", "/path/to/your/vault"]
    }
  }
}

См. docs/examples.md для получения дополнительных примеров запросов.

Документация

См. docs/README.md для:

• Справочника API

• Конфигурации и опций CLI

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

• Архитектуры разработки и хранения

• Участия в разработке

• Зависимостей

• Архитектуры и схемы базы данных

• Безопасности и поиска

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

• Разработки

• Участия в разработке

• Зависимостей

• Лицензия

Быстрый старт

Запустите сервер мгновенно с помощью npx (установка не требуется):

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Или добавьте в Claude Code/Claude Desktop (см. «Конфигурация и установка» ниже).

Устранение неполадок и FAQ

См. docs/configuration.md для решения распространенных проблем.

См. docs/search.md для получения подробной информации о весах поиска и скоринге.

См. docs/security.md для получения подробной информации о функциях безопасности и защите.

См. docs/development.md для получения информации о рабочем процессе разработки и деталях хранения.

См. docs/contributing.md для получения руководств по внесению вклада.

Архитектура хранения

Сервер использует хранилище базы данных SQLite по умолчанию для эффективной индексации и постоянного кэширования:

• Режим базы данных (по умолчанию): хранит проиндексированные заметки в .second-brain-mcp/notes.db внутри вашего хранилища

  • Постоянная индексация (сохраняется после перезапуска сервера)

  • Эффективно для больших хранилищ (1000+ заметок)

  • Полнотекстовый поиск с помощью SQLite FTS5

  • Низкое потребление памяти

• Режим памяти (опционально): используйте флаг --use-memory для хранения в оперативной памяти

  • Быстрее для небольших хранилищ (<100 заметок)

  • Отсутствие накладных расходов на ввод-вывод диска

  • Полезно для разработки и тестирования

  • Использует Fuse.js для нечеткого поиска

См. docs/architecture.md для схемы архитектуры. См. docs/database-schema.md для схемы базы данных.

Архитектура

• src/index.ts: реализация MCP-сервера с обработчиками инструментов

• src/vault.ts: оркестрация индексации хранилища и элементы управления безопасностью

• src/storage.ts: абстракция интерфейса хранилища

• src/database-storage.ts: реализация хранилища на основе SQLite

• src/memory-storage.ts: реализация хранилища в памяти с Fuse.js

• src/storage-factory.ts: паттерн «фабрика хранилищ» для выбора режима

• src/config.ts: управление конфигурацией со значениями по умолчанию

• src/types.ts: определения типов TypeScript и утилиты проверки

• src/__tests__/: модульные тесты для критически важной функциональности

См. docs/dependencies.md для получения полного списка производственных и разрабатываемых зависимостей.

Поддержка

Если second-brain-mcp экономит ваше время, рассмотрите возможность спонсирования меня на GitHub или угостите меня кофе.

Лицензия

MIT