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