Logseq MCP 工具
该项目提供了一组模型上下文协议 (MCP) 工具，使 AI 代理能够与您的本地 Logseq 实例进行交互。
安装
确保已安装 Python 3.11+
克隆此存储库
安装依赖项：
pip install -e .
Related MCP server: MCP Toolkit
设置
确保您的 Logseq 已启用 API。
在 Logseq 中，转到“设置”>“高级”>“开发者模式”>“启用开发者模式”
然后，转到插件> 打开 Logseq 开发人员插件
还可以在高级设置中设置 API 令牌
重启 Logseq
在您的 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" } } } }
或者
配置 Claude Code 以使用 MCP 服务器：
选择范围
选择 Stdio
LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp
与 Cursor 和 Claude 一起使用
添加 Cursor 的 MCP 工具
按照上面的设置部分所示配置 MCP 服务器
打开 Cursor 并转到 MCP 面板（侧边栏）
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 中的日志页面具有特定的格式和属性：
创建或访问日记页面时，请使用“mmm dth, yyyy”格式（例如“2025 年 4 月 4 日”）
期刊页面由 Logseq 自动格式化，并注明正确的日期
日志页面具有由 Logseq 自动设置的特殊属性：
journal?：true - 表示这是日志页面journalDay：YYYYMMDD - 数字格式的日期（例如，20250404 表示 2025 年 4 月 4 日）
例如：
await logseq.create_page("Apr 4th, 2025")
**重要提示：**您无需手动设置journal?或journalDay属性。只需创建一个具有正确日期格式（例如“2025 年 4 月 4 日”）的页面，即可自动将其配置为具有相应属性的日记页面。
块结构和格式
Logseq 中的块具有一些需要理解的重要特征：
自动项目符号：所有块都会在 Logseq UI 中自动呈现为项目符号
页面链接：使用双括号创建链接：
[[Page Name]]层次块：
区块结构数据包含层次信息：
parent：父块的 IDlevel：缩进级别（1 为顶层，2+ 为缩进块）left：左侧的块（通常是缩进块的父块）
块内容：创建块时，您可以包含文本格式：
支持基本 Markdown（粗体、斜体等）
区块内的要点可能支持有限
支持多行内容，但可能需要遵守 Logseq 的解析规则
日记块：在日记页面中创建的块继承了特殊属性：
journal?：是的journalDay：YYYYMMDD - 与日记页面相同
**注意：**与日记页面一样，这些区块属性由 Logseq 自动处理。在日记页面上创建区块时，您无需手动设置journal?或journalDay属性。
常见任务的示例用法
**使用 Cursor 代理：**当您在 Cursor 中配置了 Logseq MCP 工具时，您可以向代理发出如下提示：
“创建一个名为‘会议记录’的新页面，其中包含今日议程的要点”
“将今天的任务添加到我的日记页面的‘任务’部分”
“使用[[项目计划]]更新今天的日记条目，并将其子元素设置为‘已完成里程碑 1’”
“在我的图表中搜索关于‘python 项目’的块，并将它们组织到新页面上”
代理将使用适当的 Logseq 工具在您的图表上执行这些操作。