簡介

MCP日誌序列知識管理服務器是一個運行在本地的工具，允許AI助手通過日誌上下文協議訪問和查詢你的Logseq筆記數據。它支持多種功能，包括按標籤、日期和其他屬性搜索筆記內容。

主要特點

該服務器提供以下核心功能：1) 智能筆記檢索 2) 標籤和分類管理 3) 時間範圍查詢 4) 筆記內容分析 5) 安全的數據訪問。所有操作都在本地進行，確保數據隱私。

使用場景

適用於需要快速檢索和分析筆記內容的多種場景，如知識回顧、項目管理、研究支持等。特別適合結合AI助手進行高效的知識處理。

MCP日誌序列知識管理系統

智能筆記檢索支持通過標籤、關鍵字和時間範圍等多種方式快速檢索相關筆記內容。

待辦事項整合與Logseq的待辦模塊深度集成，提供任務查詢和管理功能。

內容分析工具內置自然語言處理能力，可對筆記內容進行自動摘要和關鍵詞提取。

🚀 Logseq個人知識管理系統 MCP 服務器

本項目是一個用於與您的 Logseq 個人知識管理系統交互的 MCP 服務器，支持自定義指令，能幫助用戶更高效地管理和檢索 Logseq 中的知識內容。

🚀 快速開始

安裝

在 Claude Desktop 和 Cursor 上使用：

MacOS 系統路徑：~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows 系統路徑：%APPDATA%/Claude/claude_desktop_config.json%

已發佈服務器配置示例

"mcpServers": {
  "mcp-pkm-logseq": {
    "command": "uvx",
    "args": [
      "mcp-pkm-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "your-logseq-api-token",
      "LOGSEQ_URL": "http://localhost:12315"
    }
  }
}

在 Claude Code 中運行：

claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseq

啟動 Logseq 服務器

Logseq 的 HTTP 接口是一個在桌面版 Logseq 應用程序中運行的接口。啟用後，它會啟動一個本地 HTTP 服務器（默認端口：12315），允許通過認證請求訪問您的 Logseq 知識庫。該接口支持查詢頁面和區塊、搜索內容以及可能的內容修改。

要啟用 Logseq 的 HTTP 接口服務器：

打開 Logseq，前往右上角的設置。
進入高級選項。
啟用 "開發者模式"。
啟用 "HTTP API 服務器"。
設置您的 API 密鑰（這應與 MCP 服務器配置中的 LOGSEQ_API_KEY 值匹配）。

更多詳細說明請參考：https://logseq-copilot.eindex.me/doc/setup

創建 MCP PKM Logseq 頁面

創建一個名為 "MCP PKM Logseq" 的新頁面，用於存儲與知識管理系統相關的指令。

✨ 主要特性

組件

資源

logseq://guide - 初始指令指南，介紹如何與該知識庫交互。

工具

get_personal_notes_instructions() - 獲取使用個人筆記工具的說明。
get_personal_notes(topics, from_date, to_date) - 檢索帶有指定主題標籤的個人筆記。
get_todo_list(done, from_date, to_date) - 檢索 Logseq 中的待辦事項列表。

📦 安裝指南

配置

以下環境變量可以配置：

屬性	詳情
`LOGSEQ_API_KEY`	用於與 Logseq 認證的 API 密鑰（默認值："this-is-my-logseq-mcp-token"）
`LOGSEQ_URL`	Logseq HTTP API 運行的 URL 地址（默認值："http://localhost:12315"）

🔧 技術細節

開發

構建和發佈

使用以下命令構建併發布項目：

npm run build

然後運行發佈的腳本：

node dist/index.js

調試

在開發環境中添加調試日誌，以便更輕鬆地排查問題。

添加開發服務器配置到 Claude Desktop

將以下內容添加到您的開發服務器配置中：

{
  "mcpServers": {
    "mcp-pkm-logseq": {
      "command": "uvx",
      "args": [
        "mcp-pkm-logseq"
      ],
      "env": {
        "LOGSEQ_API_TOKEN": "your-logseq-api-token",
        "LOGSEQ_URL": "http://localhost:12315"
      }
    }
  }
}