SiYuan MCP
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
- 47 204 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- MCP-сервер дает агенту доступ на чтение и запись всей базы заметок
- Требует самостоятельного развертывания и защиты доступа, включая OAuth
Установка
- Работает в
Ручная установка
docker run b3log/siyuan serve --workspace=<путь>Запуск в контейнере, с версии 3.7.0 подкоманда serve обязательна. Параметры смотрите через docker run --rm b3log/siyuan serve --help.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- MCP-сервер дает агенту доступ на чтение и запись всей базы заметок
- Требует самостоятельного развертывания и защиты доступа, включая OAuth
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SiYuan это приватная система управления знаниями с блочным Markdown-редактором, двусторонними ссылками между блоками, SQL-запросами по содержимому и экспортом в разные форматы. Ставится как десктопное приложение, мобильное приложение или Docker-контейнер и хранит данные локально или в собственной рабочей области. Отдельно от основного интерфейса в ядре SiYuan реализован MCP-сервер с инструментами для работы с блоками, вложениями, атрибутами и закладками, а также поддержкой OAuth, так что AI-агент может читать и редактировать заметки через MCP вместо прямого доступа к файлам.
Для кого. Для тех, кто ведет личную базу знаний в SiYuan и хочет, чтобы агент читал и редактировал заметки напрямую, а не через экспорт файлов.
Подходит, если
- Ведете заметки в SiYuan и хотите подключить к ним агента через MCP вместо ручного копирования текста
- Нужна приватная, самостоятельно размещаемая альтернатива облачным заметочным сервисам с блочными ссылками
- Нужен SQL-запрос или программный доступ к структуре заметок из агента
Не подходит, если
- Вы уже используете другую систему заметок и не планируете переезжать в SiYuan ради MCP
- Нужен только простой доступ к готовым текстовым файлам без блочной модели SiYuan
Пример запроса к агенту
Подключись к моей базе знаний SiYuan через MCP и найди все заметки про этот проектMCP
- Транспорт
- http
- Авторизация
- OAuth
Ограничения
MCP-сервер это встроенная функция ядра SiYuan, а не отдельно устанавливаемый пакет: чтобы им пользоваться, нужно развернуть и запустить полноценное приложение SiYuan, включить сервер в настройках и указать агенту адрес локального или сетевого инстанса. README проекта описывает саму систему заметок подробно, но не приводит отдельного пошагового руководства по настройке MCP.
Как отключить. Отключите MCP-сервер в настройках SiYuan или не открывайте доступ к нему извне; полное удаление означает деинсталляцию самого приложения SiYuan.
Частые вопросы
MCP-сервер это отдельная программа?
Нет, это встроенная часть ядра SiYuan, написанного на Go: инструменты для блоков, вложений, атрибутов и закладок работают внутри уже запущенного приложения.
Можно развернуть без десктопного приложения?
Да, README описывает Docker и Kubernetes хостинг с подкомандой serve, что подходит для запуска на сервере без графического интерфейса.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и CLI для заметок SiYuan: права на уровне блокнотов, откат правок агента и таймлайн документа.
Приложение для macOS собирает ваши знания в Markdown-папку и по желанию открывает ее ИИ-клиентам через зашифрованное MCP-зеркало с двумя инструментами
Локальная база заметок в Markdown с MCP-сервером и скиллами: Claude Code, Cursor, Codex и Gemini CLI читают один и тот же контекст
Плагин, MCP-сервер и приложение для базы знаний в Markdown: ваш ИИ-инструмент ведет страницы, а вы видите правки и цитаты.
loci собирает заметки и память агентов в одну базу знаний с гибридным поиском и ответами со ссылкой на раздел файла.
DocsMint дает агентам искать, читать и править документы базы знаний через 22 инструмента MCP, облако или свой Docker
Коротко о README
README представляет SiYuan как приватную систему управления знаниями с блочными ссылками, WYSIWYG Markdown-редактором, SQL-запросами, карточками для интервального повторения и экспортом в PDF, Word и HTML. Установка описана подробно: приложение из App Market, установочные пакеты, менеджеры пакетов, Docker, Kubernetes, Unraid и TrueNAS хостинг, плюс отдельный раздел про интерфейс командной строки. При этом текст README не упоминает MCP напрямую, хотя в исходном коде ядра есть отдельный пакет kernel/mcp с инструментами для работы с блоками, вложениями и закладками, а также поддержкой OAuth.