SiYuan Sisyphus MCP
MCP-сервер и CLI для заметок SiYuan: права на уровне блокнотов, откат правок агента и таймлайн документа.
- 123 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент пишет в заметки SiYuan, а при уровне `rwd` может удалять документы.
- Нативные инструменты SiYuan и чужих плагинов не ограничены правами Sisyphus.
Установка
- Работает в
Ручная установка
npm i -g siyuan-sisyphusСтавит CLI. Плагин для самого SiYuan берут в его маркетплейсе, а команда `siyuan-sisyphus init` задает адрес API и токен.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент пишет в заметки SiYuan, а при уровне `rwd` может удалять документы.
- Нативные инструменты SiYuan и чужих плагинов не ограничены правами Sisyphus.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SiYuan Sisyphus пускает агента в заметки SiYuan только туда, куда разрешено. Больше сотни возможностей SiYuan собраны в 14 инструментов с выбором действия, подробная справка и навыки подгружаются по необходимости, чтобы не раздувать контекст. Пути вида `/Блокнот/Проект/Заметка` избавляют агента от идентификаторов блоков. Каждый блокнот получает уровень `none`, `r`, `rw` или `rwd`, а удаление, перенос и замену включают отдельными переключателями. Запись проверяется по хэшу текущего состояния, выполняется один раз и перечитывается. Перед работой агента можно создать узел таймлайна, сравнить его с документом и откатить документ или один блок. Через MCP Apps в диалоге открываются повторение карточек, таймлайн и магазин талисмана, решение принимает человек. Команды CLI `siyuan-sisyphus` вызывают те же инструменты из терминала.
Для кого. Пользователям SiYuan, которые ведут в нем рабочие заметки и хотят дать агенту доступ с ограничениями и возможностью отката.
Подходит, если
- Агент приводит в порядок недельный обзор, а правки потом надо просмотреть блок за блоком.
- Одному блокноту доступно только чтение, другому запись, а третий закрыт.
- Скрипту в терминале нужен список блокнотов в формате JSON.
- Агенту нужна справка по разметке SiYuan, и ее не хочется держать в контексте постоянно.
Не подходит, если
- SiYuan младше 2.9.0: плагин на нем не запустится.
- Агенту нужно полностью открыть всю базу, включая нативные инструменты SiYuan, без ограничений.
- Заметки хранятся в другом приложении.
Пример запроса к агенту
Покажи мои блокноты SiYuan и найди заметки про недельный обзор, ничего не меняя.MCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Ограничения
Плагин работает на SiYuan 2.9.0 и новее, официальный мост MCP и эндпоинт ядра требуют 3.7.0. Блокнотам без записи в настройках доступно только чтение, а созданные после установки стартуют на уровне `rwd`: проверьте уровни до первого запроса. Инструменты других плагинов и нативные инструменты SiYuan проходят мимо прав Sisyphus, поэтому нативные включайте только для локальных доверенных клиентов. Таймлайн опирается на снимки рабочего пространства и не заменяет Git.
Как отключить. Отключите плагин в настройках SiYuan и удалите запись MCP из клиента. CLI снимается командой `npm uninstall -g siyuan-sisyphus`.
Частые вопросы
Как подключить SiYuan Sisyphus к Claude Code?
Поставьте плагин из маркетплейса SiYuan, откройте настройки плагина, раздел подключения MCP, выберите клиента и транспорт и скопируйте готовую конфигурацию. Есть пресеты для Claude Code, Codex CLI, Cursor и OpenCode.
Что агент может делать с блокнотом?
Это определяет уровень блокнота: `none` закрывает, `r` читает, `rw` пишет, `rwd` еще и удаляет. Удаление, перенос и замена требуют подтверждения.
Как откатить правки агента?
Создайте узел таймлайна до начала работы, затем сравните его с документом и восстановите документ целиком или один блок. Откат для ИИ по умолчанию выключен.
Чем CLI отличается от MCP?
Они используют одно ядро. MCP подходит агентам с многошаговой работой, CLI удобнее для скриптов и разовых задач и не загружает схемы инструментов в контекст.
Какая версия SiYuan нужна?
Плагин работает на SiYuan 2.9.0 и новее. Официальный мост MCP и эндпоинт ядра требуют версии 3.7.0.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСамостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
Заметки в Markdown, задачи и канбан-доска в терминале; агент читает их и двигает карточки через CLI с JSON или MCP.
MCP-эндпоинт рабочего пространства Salt на вашем сервере: агент создает страницы и базы, ищет и комментирует с правами человека.
MCP-сервер для Feishu и Lark: агент читает и правит документы блоками, ведет задачи и ищет коллег, а набор инструментов доступен и как CLI
MCP-сервер и приложение для Mac: один локальный индекс репозиториев, сессий агентов и задач, поиск по смыслу и нити работы
Simplenote MCP — заметки Simplenote в агенте
simplenote-mcp
Официальный MCP-сервер Simplenote от Automattic: агент читает, ищет и по желанию правит заметки, на macOS работает без входа
Коротко о README
Проект движется к совместимости с официальным MCP SiYuan и к простой настройке в популярных агентах. Об ошибках можно сообщить в Issues или вызовом встроенного инструмента `feedback`.