logseq-mcp

🚀 Logseq MCP 工具集

本项目提供了一套模型上下文协议（MCP）工具，借助这些工具，AI 代理能够与本地的 Logseq 实例展开交互，为您的工作流程带来便利。

🚀 快速开始

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

📦 安装指南

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

pip install -e .

📚 详细文档

设置

1. 确保您的 Logseq 已启用 API：
   • 在 Logseq 中，转到设置 > 高级 > 开发人员模式 > 启用开发人员模式。
   • 然后转到插件 > 启用 Logseq 开发人员插件。
   • 还需在高级设置中设置一个 API 令牌。
   • 重启 Logseq。
2. 在您的 Cursor MCP 配置文件（通常位于 ~/.cursor/mcp.json）中配置 MCP 服务器：

{
    "mcpServers": {
        "logseq": {
            "command": "/opt/homebrew/bin/uvx",
            "args": ["-p", "5000"],
            "env": {}
        }
    }
}

在 Cursor 和 Claude 中使用

常见任务示例

与 Cursor 代理一起使用：

• “创建一个名为 '会议记录' 的新页面，带有今天议程的要点”
• “将今天的任务添加到我的日记页面，并在 '任务' 部分下组织它们”
• “更新今天的日记条目以包含 [[项目计划]]，并将其子项设置为 '完成第一个里程碑'”
• “搜索我的图谱中有关 'python 项目' 的所有块，并将它们整理到新页面上”

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

可用工具

页面操作

• get_all_pages()：获取所有页面。
• create_page(name: str, content: str)：创建一个新页面。
• delete_page(name: str)：删除指定页面。

块操作

• search_blocks(query: str)：搜索所有满足条件的块。
• get_block_children(block_id: str)：获取指定块的所有子块。
• create_block(parent_id: str, content: str)：在指定父块下创建新块。
• update_block_content(block_id: str, new_content: str)：更新指定块的内容。

与 Logseq 配合使用

日记页面

• 格式：使用日期作为页面名称，例如 2023-10-05。
• 属性：自动设置 journal? 和 journalDay 属性。

块结构

• 属性：包括 created、updated 和 content。
• 操作：支持创建、更新和删除块。

💻 使用示例

与 Cursor 代理一起使用：当在 Cursor 中配置了 Logseq MCP 工具后，您可以指示代理执行以下任务：

• “添加今天的工作重点到我的日记页面”
• “从 '项目计划' 页面复制所有内容并粘贴到新页面上”

代理将根据需要调用适当的工具来完成操作。