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

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

Установка

1. Убедитесь, что у вас установлен Python 3.11+

2. Клонировать этот репозиторий

3. Установите зависимости:

   pip install -e .

Related MCP server: MCP Toolkit

Настраивать

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 для выполнения этих операций на вашем графике.