mcp-logseq — MCP-сервер для Logseq
MCP server for LogSeq
MCP-сервер для Logseq: агент читает, ищет и правит страницы и блоки графа через локальный HTTP API
- 348 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент может создавать, менять и удалять страницы и блоки вашего графа, если не задан список разрешенных пространств имен для записи
- Заметки читаются целиком, а при размещенных эмбеддингах их текст уходит стороннему провайдеру
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-for-logseqОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент может создавать, менять и удалять страницы и блоки вашего графа, если не задан список разрешенных пространств имен для записи
- Заметки читаются целиком, а при размещенных эмбеддингах их текст уходит стороннему провайдеру
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к Logseq через его локальный HTTP API и дает 17 инструментов для страниц и блоков. Агент создает, читает, правит, переименовывает и удаляет страницы. С блоками он работает по UUID, в том числе с вложенными, а еще видит обратные ссылки, ищет и выполняет запросы на языке запросов Logseq. Страницы можно выбирать по свойству, а пространства имен смотреть деревом. Тексты в Markdown сервер сам превращает в блоки Logseq: заголовки дают разделы, списки становятся вложенными блоками, YAML-шапка превращается в свойства страницы, а флажки в задачи TODO и DONE. Если название страницы уже занято, создание завершается ошибкой, поэтому повтор после таймаута не плодит дубли вроде Page(1). Отдельно включается семантический поиск по смыслу с тремя своими инструментами. Эмбеддинги считает локальная Ollama или OpenAI-совместимый провайдер, а векторная база LanceDB остается на вашем компьютере. Для графов Logseq в режиме DB есть опция чтения и записи свойств классов.
Для кого. Для тех, кто ведет заметки в Logseq и хочет, чтобы Claude Code, Codex или OpenCode разбирал граф, собирал сводки и создавал страницы.
Подходит, если
- Нужно собрать недельный обзор из журнальных страниц и записать его новой страницей
- Надо найти незакрытые задачи TODO по всему графу и свести их в список
- Протокол встречи требуется разложить на отдельные страницы задач с вложенными блоками
- Хочется искать заметки по смыслу, даже если в них нет нужного слова, для этого подходит векторный поиск
- Агент должен видеть только часть графа, например без страниц с приватными тегами
Не подходит, если
- Заметки лежат в Obsidian или другом хранилище: сервер работает только с Logseq
- Приложение Logseq закрыто: HTTP API работает, пока запущен сервер внутри приложения
- Нужны сложные выборки на сыром datalog: инструмент query принимает только запросы на языке Logseq
- Заметки нельзя отправлять внешнему провайдеру: при размещенных эмбеддингах текст уходит на их сервер
Пример запроса к агенту
Найди на всех страницах незакрытые задачи TODO с тегом проекта и создай страницу со сводкой по срокам.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
LOGSEQ_API_TOKENобязательная, секрет- Токен авторизации, созданный в панели API Logseq.
LOGSEQ_API_URL- Адрес API Logseq, по умолчанию http://localhost:12315.
LOGSEQ_EXCLUDE_TAGS- Теги через запятую: страницы с ними скрыты от агента.
Ограничения
В Logseq нужно включить сервер HTTP API в настройках, запустить его кнопкой и создать токен авторизации. Для запуска понадобится менеджер пакетов uv.
Доступ агента ограничивается на уровне страниц: скрыть можно страницы по тегам, оставить только нужные пространства имен или разрешить запись лишь в некоторых из них. Без этих настроек агент видит и меняет весь граф, включая удаление страниц и блоков.
Инструмент query понимает язык запросов Logseq, сырой datalog он не принимает. Векторный поиск пока экспериментальный и требует отдельной настройки. Доступность провайдеров эмбеддингов из России не проверена.
Как отключить. Удалите сервер командой claude mcp remove mcp-logseq или уберите его блок из конфигурации клиента, затем отзовите токен в панели API Logseq.
Частые вопросы
Как подключить Logseq к Claude Code?
После включения HTTP API и создания токена выполните claude mcp add mcp-logseq с переменными LOGSEQ_API_TOKEN и LOGSEQ_API_URL и командой uv run --with mcp-logseq mcp-logseq. Ставить пакет заранее не нужно, uv скачает его сам.
Можно ли ограничить, какие страницы видит агент?
Да. Переменная LOGSEQ_EXCLUDE_TAGS скрывает страницы с указанными тегами, LOGSEQ_INCLUDE_NAMESPACES оставляет только перечисленные пространства имен, а LOGSEQ_WRITE_NAMESPACES разрешает запись лишь в части из них. Скрытые страницы не попадают ни в списки, ни в поиск.
Как включить семантический поиск?
Он необязателен, настройку разбирает отдельное руководство VECTOR_SEARCH.md. После нее у агента появляются инструменты vector_search, sync_vector_db и vector_db_status.
Работает ли сервер с Codex и OpenCode?
Да, в документации есть готовые настройки для Codex CLI в файле config.toml и для OpenCode в opencode.json. Для Codex адрес API указывают без суффикса mcp, сервер запускается как stdio.
Что будет, если страница с таким названием уже есть?
Инструмент create_page вернет ошибку и копию не создаст. Для больших записей автор советует создать страницу почти пустой, дописывать части через update_page и проверять результат чтением.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыObsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
MCP-сервер на Rust для папки с заметками в Markdown: агент ищет, читает заметки, видит обратные ссылки, теги, задачи и историю версий
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
MCP-сервер для Linear: задачи, проекты, циклы, вехи, документы и апдейты проектов через GraphQL API
Minutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
Скилл и MCP-сервер дают агенту искать и разбирать расшифровки встреч, лекций и стримов из приложения DeLive
Коротко о README
Документация разбирает примеры запросов к графу и дает таблицу всех инструментов. Отдельные разделы посвящены приватным страницам, разделению доступа на чтение и запись и настройке разных клиентов.