Logseq MCP 工具

该项目提供了一组模型上下文协议（MCP）工具，使AI代理能够与您的本地Logseq实例进行交互。

安装

1. 确保已安装Python 3.11+
2. 克隆此仓库
3. 安装依赖项：
   bash
   pip install -e .

设置

1. 确保您的Logseq已启用API。

   • 在Logseq中，转到设置 > 高级 > 开发者模式 > 启用开发者模式
   • 然后，转到插件 > 打开Logseq开发者插件
   • 还需在高级设置中设置一个API令牌
   • 重启Logseq

2. 在您的Cursor MCP配置文件（通常位于~/.cursor/mcp.json）中配置MCP服务器：
   json
   {
   "mcpServers": {
   "logseq": {
   "command": "/opt/homebrew/bin/uvx",
   "args": ["logseq-mcp"],
   "env": {
   "LOGSEQ_API_URL": "http://localhost:12315",
   "LOGSEQ_TOKEN": "your-token-here"
   }
   }
   }
   }

或者

1. 使用以下命令通过Claude Code配置MCP服务器：

claude mcp add

• 选择范围
• 选择Stdio
• LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp

与Cursor和Claude一起使用

添加到Cursor的MCP工具

1. 按照上面设置部分所示配置MCP服务器

2. 打开Cursor并转到MCP面板（侧边栏）

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

与Claude一起使用

当在Cursor中使用Claude时，您需要通过类似以下提示告知它您可以访问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: 按ID获取特定块
• logseq.create_block: 在页面上创建新块
• logseq.insert_block: 将块作为另一个块的子块插入
• logseq.update_block: 更新现有块
• logseq.move_block: 将块移动到不同位置
• logseq.remove_block: 移除块及其所有子块
• logseq.search_blocks: 搜索与查询匹配的块

使用Logseq

日记页面

Logseq中的日记页面具有特定格式和属性：

1. 创建或访问日记页面时，请使用"mmm dth, yyyy"格式（例如："Apr 4th, 2025"）
2. 日记页面由Logseq自动按正确的日期格式化
3. 日记页面具有由Logseq自动设置的特殊属性：
   • journal?: true - 表示这是一个日记页面
   • journalDay: YYYYMMDD - 数字格式的日期（例如，2025年4月4日为20250404）
4. 示例：await logseq.create_page("Apr 4th, 2025")

重要提示： 您无需手动设置journal?或journalDay属性。只需以正确的日期格式（例如"Apr 4th, 2025"）创建页面，即可自动将其配置为带有适当属性的日记页面。

块结构和格式

Logseq中的块有一些重要的特性需要了解：

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

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

3. 层次结构块：

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

4. 块内容：创建块时，可以包括文本格式：- 基本的 Markdown 格式是支持的（如加粗、斜体等）

• 代码块内的项目符号列表可能支持有限
• 多行内容是支持的，但可能会受到 Logseq 解析规则的影响

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

注意: 就像日记页面一样，这些块属性由 Logseq 自动处理。在日记页面上创建块时，不需要手动设置 journal? 或 journalDay 属性。

常见任务示例用法

使用 Cursor 代理:
当您在 Cursor 中配置了 Logseq MCP 工具后，可以给代理提供如下提示：

• "创建一个名为 'Meeting Notes' 的新页面，并添加今天的议程作为项目符号"
• "在我的日记页面中添加今天的任务，并将其放在 'Tasks' 部分"
• "更新今天的日记条目，添加 [[Project Plan]]，并将其子元素设置为 'Completed milestone 1'"
• "在我的图谱中搜索关于 'python projects' 的块，并将它们组织到一个新的页面上"

代理将使用适当的 Logseq 工具来执行这些操作。