MCP Pkm 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 接口服務器：

1. 打開 Logseq，前往右上角的設置。
2. 進入高級選項。
3. 啟用 "開發者模式"。
4. 啟用 "HTTP API 服務器"。
5. 設置您的 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 中的待辦事項列表。

📦 安裝指南

配置

以下環境變量可以配置：

🔧 技術細節

開發

構建和發佈

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

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"
      }
    }
  }
}