ergut/mcp-logseq

解决的问题

该项目提供了一个 Model Context Protocol (MCP) 服务器，将 Claude 等 AI 助手连接到 LogSeq 知识库。无需手动导出或复制笔记，AI 可直接在您的 LogSeq 图谱中读取、创建和管理页面与块。

工作原理

该服务器充当 MCP 兼容客户端与 LogSeq HTTP API 之间的桥梁。它提供了一套 17 个核心工具用于页面和块操作，以及 3 个可选工具用于语义搜索。它包含一个智能 Markdown 解析器，可将 AI 生成的 Markdown 自动转换为 LogSeq 的原生块结构，确保标题、嵌套列表和属性得以保留。

适用人群

希望自动化知识管理、在笔记间执行复杂分析，或使用 AI 助手整理和记录研究与会议笔记的 LogSeq 用户。

主要亮点

• 完整图谱管理：支持列出、读取、创建、更新和删除页面与块。
• 语义向量搜索：可选支持通过本地（Ollama）或托管（OpenAI）嵌入，利用 LanceDB 按语义查找笔记。
• 隐私控制：通过排除标签和命名空间的允许/拒绝列表，实现细粒度访问控制，防止 AI 访问敏感内容。
• 智能 Markdown 解析：自动将 AI 生成的 Markdown 转换为结构化 LogSeq 块，支持 YAML 前置元数据和复选框。
• DB 模式支持：可选支持在 Logseq DB 模式图谱中读写类属性。
• 企业级部署：支持 stdio、带 Bearer 认证的 HTTP 传输以及 TLS，适用于远程客户端。