JinDaGe - mcp-pkm-logseq MCP Details

article

README

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

mcp-pkm-logseq