Logseq MCP Tools

Инструменты Logseq MCP

Этот проект предоставляет набор инструментов Model Context Protocol (MCP), которые позволяют агентам ИИ взаимодействовать с локальным экземпляром Logseq.

Установка

1. Убедитесь, что у вас установлен Python 3.11+
2. Клонировать этот репозиторий
3. Установите зависимости:
   pip install -e .

Настраивать

1. Убедитесь, что в вашем Logseq включен API.
   • В Logseq перейдите в Настройки > Дополнительно > Режим разработчика > Включить режим разработчика.
   • Затем перейдите в раздел «Плагины» > «Включить плагин разработчика Logseq».
   • Также установите API-токен в дополнительных настройках.
   • Перезапустить Logseq
2. Настройте сервер MCP в файле конфигурации Cursor MCP (обычно в ~/.cursor/mcp.json ):
   { "mcpServers": { "logseq": { "command": "/opt/homebrew/bin/uvx", "args": ["logseq-mcp"], "env": { "LOGSEQ_API_URL": "http://localhost:12315", "LOGSEQ_TOKEN": "your-token-here" } } } }

ИЛИ

3. Настройте Claude Code для использования сервера MCP с:

• Выберите область применения
• Выбрать Stdio
• LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp

Использование с Курсором и Клодом

Добавление в MCP Tools Курсора

1. Настройте сервер MCP, как показано выше в разделе «Настройка».
2. Откройте курсор и перейдите на панель MCP (боковая панель)
3. Инструмент Logseq должен появиться в списке доступных инструментов.

Использование с Клодом

При использовании Claude в Cursor вам необходимо сообщить ему, что у вас доступны инструменты Logseq, с помощью примерно такого запроса:

«У вас есть доступ к инструментам Logseq, которые помогут вам взаимодействовать с моим графиком Logseq. Вы можете использовать такие функции, как logseq.get_all_pages(), logseq.get_page(name), logseq.create_page(name) и т. д.»

Доступные инструменты

Все инструменты доступны в пространстве имен logseq :

Страницы

• logseq.get_all_pages : Получить список всех страниц в графике Logseq
• logseq.get_page : Получить конкретную страницу по имени
• logseq.create_page : Создать новую страницу
• logseq.delete_page : Удалить страницу и все ее блоки

Блоки

• logseq.get_page_blocks : Получить все блоки с определенной страницы
• logseq.get_block : Получить определенный блок по идентификатору
• logseq.create_block : Создать новый блок на странице
• logseq.insert_block : Вставить блок как дочерний элемент другого блока
• logseq.update_block : обновить существующий блок
• logseq.move_block : Переместить блок в другое место
• logseq.remove_block : Удалить блок и все его дочерние элементы
• logseq.search_blocks : Поиск блоков, соответствующих запросу

Работа с Logseq

Страницы журнала

Страницы журнала в Logseq имеют определенный формат и атрибуты:

1. Используйте формат «ммм дт, гггг» (например, «4 апр. 2025 г.») при создании или доступе к страницам журнала.
2. Страницы журнала автоматически форматируются Logseq с правильной датировкой
3. Страницы журнала имеют специальные атрибуты, которые автоматически устанавливаются Logseq:
   • journal? : true - Указывает, что это страница журнала
   • journalDay : YYYYMMDD - дата в числовом формате (например, 20250404 для 4 апреля 2025 г.)
4. Пример: await logseq.create_page("Apr 4th, 2025")

Важно: Вам не нужно вручную устанавливать атрибуты journal? или journalDay . Простое создание страницы с правильным форматом даты (например, "4 апреля 2025 г.") автоматически настроит ее как страницу журнала с соответствующими атрибутами.

Структура блока и форматирование

Блоки в Logseq имеют некоторые важные характеристики, которые следует понимать:

1. Автоматические маркеры : все блоки автоматически отображаются в виде маркеров в пользовательском интерфейсе Logseq.
2. Ссылки на страницы : создайте ссылки, используя двойные скобки: [[Page Name]]
3. Иерархические блоки :
   • Данные о структуре блока содержат иерархическую информацию:
     • parent : идентификатор родительского блока
     • level : уровень отступа (1 для верхнего уровня, 2+ для блоков с отступом)
     • left : Блок слева (обычно родительский для блоков с отступом)
4. Содержимое блока : при создании блоков вы можете включить форматирование текста:
   • Поддерживается базовый Markdown (жирный, курсив и т. д.)
   • Маркированные списки внутри блока могут иметь ограниченную поддержку
   • Многострочный контент поддерживается, но может подчиняться правилам синтаксического анализа Logseq.
5. Блоки журнала : Блоки, созданные на страницах журнала, наследуют специальные атрибуты:
   • journal? : правда
   • journalDay : YYYYMMDD - То же, что и на странице журнала

Примечание: Как и страницы журнала, эти атрибуты блока автоматически обрабатываются Logseq. Вам не нужно вручную устанавливать атрибуты journal? или journalDay при создании блоков на страницах журнала.

Пример использования для общих задач

Работа с агентом Cursor: если в Cursor настроены инструменты Logseq MCP, вы можете давать агенту такие запросы:

• «Создайте новую страницу под названием «Заметки о встрече» с тезисами повестки дня на сегодня»
• «Добавить сегодняшние задачи на страницу моего журнала с разделом «Задачи»»
• «Обновить сегодняшнюю запись в журнале с помощью [[План проекта]], установить его дочерний элемент на «Завершенная веха 1»»
• «Найдите в моем графике блоки о «проектах Python» и организуйте их на новой странице»

Агент будет использовать соответствующие инструменты Logseq для выполнения этих операций на вашем графике.