Logseq MCP 工具

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

安装

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

   pip install -e .
   

配置

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

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

2. 在您的Cursor MCP配置文件中配置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服务器：

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 - 日期的数字格式（例如，2_250404表示2025年4月4日）
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解析规则的影响
5. 日记块：在日记页面中创建的块继承特殊属性：
   • journal?: true
   • journalDay: YYYYMMDD - 与日记页面相同

注意： 类似于日记页面，这些块属性由Logseq自动处理。在日记页面上创建块时，您不需要手动设置journal?或journalDay属性。

常见任务示例用法

与Cursor代理合作： 当您在Cursor中配置了Logseq MCP工具，可以给代理提示如下：

• “创建名为'Meeting Notes'的新页面，并添加今天的议程项目符号”
• “在我的日记页面中添加今天的任务，并创建'Tasks'部分”
• “更新今天的日记条目，加入[[Project Plan]]，并将它的子元素设置为'已完成里程碑1'”
• “搜索我的图中关于'python projects'的块，并将它们组织在一个新的页面上”

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