SiYuan
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- MCP-сервер дает агенту доступ на чтение и запись всей базы заметок
- Требует самостоятельного развертывания и защиты доступа, включая OAuth
Установка
Ручная установка
docker run b3log/siyuan serve --workspace=<путь>Запуск в контейнере, с версии 3.7.0 подкоманда serve обязательна. Параметры смотрите через docker run --rm b3log/siyuan serve --help.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SiYuan это приватная система управления знаниями с блочным Markdown-редактором, двусторонними ссылками между блоками, SQL-запросами по содержимому и экспортом в разные форматы. Ставится как десктопное приложение, мобильное приложение или Docker-контейнер и хранит данные локально или в собственной рабочей области. Отдельно от основного интерфейса в ядре SiYuan реализован MCP-сервер с инструментами для работы с блоками, вложениями, атрибутами и закладками, а также поддержкой OAuth, так что AI-агент может читать и редактировать заметки через MCP вместо прямого доступа к файлам.
Для кого. Для тех, кто ведет личную базу знаний в SiYuan и хочет, чтобы агент читал и редактировал заметки напрямую, а не через экспорт файлов.
Подходит, если
- Ведете заметки в SiYuan и хотите подключить к ним агента через MCP вместо ручного копирования текста
- Нужна приватная, самостоятельно размещаемая альтернатива облачным заметочным сервисам с блочными ссылками
- Нужен SQL-запрос или программный доступ к структуре заметок из агента
Не подходит, если
- Вы уже используете другую систему заметок и не планируете переезжать в SiYuan ради MCP
- Нужен только простой доступ к готовым текстовым файлам без блочной модели SiYuan
Пример запроса к агенту
Подключись к моей базе знаний SiYuan через MCP и найди все заметки про этот проектОграничения
MCP-сервер это встроенная функция ядра SiYuan, а не отдельно устанавливаемый пакет: чтобы им пользоваться, нужно развернуть и запустить полноценное приложение SiYuan, включить сервер в настройках и указать агенту адрес локального или сетевого инстанса. README проекта описывает саму систему заметок подробно, но не приводит отдельного пошагового руководства по настройке MCP.
Как отключить. Отключите MCP-сервер в настройках SiYuan или не открывайте доступ к нему извне; полное удаление означает деинсталляцию самого приложения SiYuan.
MCP
- Транспорт
- http
- Авторизация
- OAuth
Проверка безопасности
- MCP-сервер дает агенту доступ на чтение и запись всей базы заметок
- Требует самостоятельного развертывания и защиты доступа, включая OAuth
Коротко о README
README представляет SiYuan как приватную систему управления знаниями с блочными ссылками, WYSIWYG Markdown-редактором, SQL-запросами, карточками для интервального повторения и экспортом в PDF, Word и HTML. Установка описана подробно: приложение из App Market, установочные пакеты, менеджеры пакетов, Docker, Kubernetes, Unraid и TrueNAS хостинг, плюс отдельный раздел про интерфейс командной строки. При этом текст README не упоминает MCP напрямую, хотя в исходном коде ядра есть отдельный пакет kernel/mcp с инструментами для работы с блоками, вложениями и закладками, а также поддержкой OAuth.
Частые вопросы
MCP-сервер это отдельная программа?
Нет, это встроенная часть ядра SiYuan, написанного на Go: инструменты для блоков, вложений, атрибутов и закладок работают внутри уже запущенного приложения.
Можно развернуть без десктопного приложения?
Да, README описывает Docker и Kubernetes хостинг с подкомандой serve, что подходит для запуска на сервере без графического интерфейса.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании