ergut/mcp-logseq

解决的问题

本项目提供了一个 Model Context Protocol (MCP) 服务器，将 Claude 等 AI 助手连接到 LogSeq 知识库。它消除了手动导出或复制笔记的需求，允许 AI 直接在用户的本地图谱中读取、创建和管理页面与区块。

工作原理

该服务器作为兼容 MCP 的客户端（例如 Claude Desktop 或 Claude Code）与 LogSeq HTTP API 之间的桥梁。它公开了 16 个用于页面和区块操作的核心工具，包括执行 Logseq DSL 查询和管理命名空间的能力。

可选的高级功能包括：

• 语义向量搜索：使用本地 (Ollama) 或托管 (OpenAI) 的嵌入配合 LanceDB，通过语义而不仅仅是关键字来查找笔记。
• 访问控制：根据排除的标签或特定的命名空间允许/拒绝列表来过滤内容，以将私人笔记隐藏不让 AI 看见。
• DB 模式支持：允许 Logseq DB 模式图谱的用户读取和写入类属性。

适用对象

想要自动化知识管理、跨笔记执行复杂分析，或使用 AI 直接在现有知识图谱中组织和生成内容的 LogSeq 用户。

亮点

• 直接图谱交互：无需离开 AI 界面即可创建、更新、删除和重命名页面与区块。
• 智能 Markdown 解析：自动将标准 Markdown 转换为 Logseq 原生的嵌套区块结构。
• 语义搜索：可选择与向量数据库集成，进行基于语义的检索。
• 隐私控制：使用标签和命名空间对 AI 可见的内容进行精细控制。
• 灵活部署：支持标准 stdio 通信以及具有 TLS 和持有者身份验证的长效 HTTP 服务。