logseq-mcp

Logseq MCP 工具

安装

1. 确保已安装 Python 3.11 或更高版本

2. 克隆本仓库

3. 安装依赖：

配置

1. 确保您的 Logseq 已启用 API：
• 在 Logseq 中，进入 Settings > Advanced > Developer mode，启用开发者模式
• 然后，进入 Plugins，启用 Logseq 开发者插件
• 在高级设置中设置 API Token
• 重启 Logseq

2. 在 Cursor MCP 配置文件中配置 MCP 服务器（通常位于 ~/.cursor/mcp.json）：

与 Cursor 和 Claude 配合使用

添加到 Cursor 的 MCP 工具

1. 按照上述配置部分设置 MCP 服务器

2. 打开 Cursor，进入 MCP 面板（侧边栏）

3. Logseq 工具应出现在可用工具列表中

与 Claude 配合使用

可用工具

页面

• logseq.get_all_pages：获取 Logseq 图谱中所有页面的列表

• logseq.get_page：按名称获取特定页面

• logseq.create_page：创建新页面

• logseq.delete_page：删除页面及其所有块

块

• logseq.get_page_blocks：获取特定页面的所有块

• logseq.get_block：按 ID 获取特定块

• logseq.create_block：在页面上创建新块

• logseq.insert_block：将块插入为另一个块的子块

• logseq.update_block：更新现有块

• logseq.move_block：将块移动到不同位置

• logseq.remove_block：移除块及其所有子块

• logseq.search_blocks：搜索匹配查询的块

使用 Logseq

日志页面

1. 创建或访问日志页面时，使用格式 "mmm dth, yyyy"（例如 "Apr 4th, 2025"）

2. 日志页面由 Logseq 自动格式化，带有正确的日期

3. 日志页面具有 Logseq 自动设置的特殊属性：
• journal?: true - 表示这是一个日志页面
• journalDay: YYYYMMDD - 数字格式的日期（例如 20250404 表示 2025 年 4 月 4 日）

4. 示例：await logseq.create_page("Apr 4th, 2025")

块结构与格式化

1. 自动项目符号：所有块在 Logseq UI 中自动呈现为项目符号

2. 页面链接：使用双括号创建链接：[[Page Name]]

3. 层级块：
• 块结构数据包含层级信息：
• parent：父块的 ID
• level：缩进级别（1 表示顶级，2+ 表示缩进块）
• left：左侧的块（通常是缩进块的父块）

4. 块内容：创建块时，可以包含文本格式化：
• 支持基本的 Markdown（粗体、斜体等）
• 块内的项目符号支持可能有限
• 支持多行内容，但可能受 Logseq 解析规则的限制

5. 日志块：在日志页面中创建的块继承特殊属性：
• journal?: true
• journalDay: YYYYMMDD - 与日志页面相同

常见任务示例

• “创建一个名为 'Meeting Notes' 的新页面，并添加今天议程的项目符号”

• “将今天的任务添加到我的日志页面，并创建一个 'Tasks' 部分”

• “更新今天的日志条目，添加 [[Project Plan]]，并将其子元素设置为 'Completed milestone 1'”

• “在我的图谱中搜索关于 'python projects' 的块，并将它们组织到一个新页面上”