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 服務。