Clew Study Assist MCP
MCP-сервер, который показывает ассистенту ваши графы обучения из Clew: темы с незакрытыми предпосылками, заметки и прогресс
- 213 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Сервер только читает локальную базу SQLite с вашими графами и заметками и не меняет их
Установка
- Работает в
Ручная установка
claude mcp add "Clew Study Assist" /absolute/path/to/clew/.venv/bin/clew-study-assistСначала поставьте Clew из исходников: git clone, cp .env.example .env и ./scripts/dev.sh. Путь замените на путь вашего клона.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сервер только читает локальную базу SQLite с вашими графами и заметками и не меняет их
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Clew строит карту тем и предварительных знаний вокруг того, что вы хотите выучить, и ведет по ней с помощью ИИ. Встроенный MCP-сервер `clew-study-assist` отдает эту карту другому ассистенту, например Claude Code, Claude Desktop или Cursor, по протоколу stdio. Ассистент видит, что вы изучаете, какие темы заблокированы незакрытыми предпосылками и что записано в каждой заметке. Копировать состояние графа в чат не нужно. Инструментов четыре, и все они только читают. `list_graphs` выдает все графы со статистикой прогресса. `get_current_learning_context` собирает сводку по активному графу и остальным графам с активностью. `get_node` возвращает тему целиком: описание, ресурсы, артефакты, соседей и блокирующие предпосылки. `search_notes` ищет по названиям, слагам и описаниям в одном графе или во всех. Правки графа остаются в интерфейсе Clew с обзором предложений, MCP ничего не меняет. Сервер читает ту же базу SQLite напрямую, поэтому запущенный бэкенд не нужен. Ставится сервер из исходников вместе со скриптом `./scripts/dev.sh`, установщики для рабочего стола внешних ассистентов не настраивают.
Для кого. Тем, кто учится по карте тем в Clew и хочет, чтобы Claude Code или Cursor сам знал, что уже пройдено, а что мешает двигаться дальше.
Подходит, если
- Спрашиваете у ассистента, что учить дальше, и нужен ответ с учетом незакрытых предпосылок
- Просите объяснить тему из графа, и ассистенту нужны ее описание, ресурсы и соседние темы
- Ищете свои заметки по ключевому слову сразу по нескольким графам
- Ведете несколько графов, и ассистент должен видеть прогресс по каждому
- Хотите, чтобы чужой ассистент читал граф без права что-то менять
Не подходит, если
- Clew не установлен: сервер читает базу этого приложения и без графов бесполезен
- Нужно править граф из чата: через MCP правки не проходят, они делаются в интерфейсе Clew
- Ожидается установка из настольного установщика одним кликом: готовой команды в PATH установщик не создает
- Заметки лежат в другом сервисе: тогда нужен MCP самого того сервиса
Пример запроса к агенту
Загляни в мои графы Clew и скажи, какие темы по машинному обучению заблокированы и что мне стоит выучить первымMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
CLEW_DB_PATH- Путь к файлу базы SQLite с графами, если нужна база не из каталога клона.
Ограничения
- Сервер ставится из исходников: клонирование репозитория и `./scripts/dev.sh`. Нужны Node 22.22.2 или новее, Python 3.11 или новее и хранилище учетных данных ОС.
- По умолчанию читается база из каталога клона. Чтобы увидеть графы настольного приложения, укажите путь к его базе в переменной окружения, адрес смотрите в разделе про данные `docs/DESKTOP.md`. В документации эта переменная названа `CLEW_DB_PATH`, а в другом месте `KG_DB_PATH`, поэтому проверьте имя на своей версии.
- Для самого Clew нужен тариф ChatGPT Plus или Pro, а сборки 1.0.0 не имеют подписи Developer ID и Authenticode.
- Сервер только читает, никаких действий над графом через MCP выполнить нельзя.
Как отключить. Удалите запись `Clew Study Assist` из `mcpServers` в `claude_desktop_config.json` или `~/.claude.json`, либо выполните `claude mcp remove "Clew Study Assist"`. Для Cursor уберите сервер в настройках MCP. Перезапустите клиент. Сами графы не затрагиваются.
Частые вопросы
Как подключить Clew к Claude Code?
Сначала установите Clew из исходников, после чего появится бинарник `.venv/bin/clew-study-assist`. Затем выполните `claude mcp add "Clew Study Assist" /абсолютный/путь/к/clew/.venv/bin/clew-study-assist`. Сервер появится в списке MCP после перезапуска.
Какие инструменты дает сервер?
Четыре, все только для чтения: `list_graphs`, `get_current_learning_context`, `get_node` и `search_notes`. Ассистент получает списки графов, сводку прогресса, содержимое темы и результаты поиска по заметкам.
Может ли ассистент изменить мой граф?
Нет. Сервер строго читает базу. Правки идут через интерфейс Clew по схеме «предложить и применить», и вы подтверждаете каждую.
Как показать ассистенту графы настольного приложения?
По умолчанию сервер смотрит в базу клона. Задайте в блоке `env` сервера переменную с путем к базе из каталога данных приложения. Расположение файла указано в разделе про локальные данные в `docs/DESKTOP.md`.
Как сделать так, чтобы ассистент всегда обращался к графу?
Добавьте в пользовательские инструкции клиента одну фразу: перед ответом о том, что вы изучаете, вызывать `get_current_learning_context`, а при упоминании конкретной темы использовать `search_notes` и `get_node`. Так советует документация проекта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
MCP-сервер к базе знаний, которую Beever Atlas строит из чатов Slack, Discord, Teams и Mattermost: ответы с цитатами, вики по каналам, граф связей
ChatCrystal — заметки из диалогов с агентами
ChatCrystal
Локальная база знаний: импорт диалогов Claude Code, Cursor, Codex и других агентов, заметки, поиск по смыслу и память по MCP
loci собирает заметки и память агентов в одну базу знаний с гибридным поиском и ответами со ссылкой на раздел файла.
MCP-сервер для поиска по истории разговоров Claude Code: прошлые решения, ошибки, планы и история изменений файлов.
Плагин и скилл для Claude Code, Codex и Kilo: исследует тему по вебу и собирает локальную доску знаний
Коротко о README
Страница представляет Clew как обучающую среду с интерактивным графом знаний в ChatGPT и в настольном приложении. Отдельно описаны установка приложения, приватность данных, запуск для разработки и карта каталогов. Подключение MCP вынесено в `docs/MCP_SETUP.md`.