🚀 Logseq MCP 工具集
本项目提供了一套模型上下文协议（MCP）工具，借助这些工具，AI 代理能够与本地的 Logseq 实例展开交互，为您的工作流程带来便利。
🚀 快速开始
本项目提供了一组模型上下文协议（MCP）工具，这些工具允许 AI 代理与您的本地 Logseq 实例进行交互。
📦 安装指南
- 确保已安装 Python 3.11+ 版本。
- 克隆此仓库。
- 安装依赖项：
pip install -e .
📚 详细文档
设置
- 确保您的 Logseq 已启用 API：
- 在 Logseq 中，转到设置 > 高级 > 开发人员模式 > 启用开发人员模式。
- 然后转到插件 > 启用 Logseq 开发人员插件。
- 还需在高级设置中设置一个 API 令牌。
- 重启 Logseq。
- 在您的 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 工具后，您可以指示代理执行以下任务：
- “添加今天的工作重点到我的日记页面”
- “从 '项目计划' 页面复制所有内容并粘贴到新页面上”
代理将根据需要调用适当的工具来完成操作。