基本能力
产品定位
mcp-pkm-logseq 是一个专为 Logseq 个人知识管理系统设计的 MCP 服务器,旨在通过程序化方式与用户的 Logseq 知识库进行交互,提高知识管理和检索效率。
核心功能
- 获取个人笔记指令:提供如何使用个人笔记工具的指导。
- 检索个人笔记:根据指定标签和日期范围从 Logseq 中检索个人笔记。
- 获取待办事项列表:从 Logseq 中检索待办事项列表,支持按完成状态和日期范围筛选。
适用场景
- 个人知识管理:帮助用户高效管理和检索个人笔记。
- 任务管理:通过程序化方式管理待办事项,提高任务跟踪效率。
- AI辅助:为AI助手提供结构化访问个人知识库的能力。
工具列表
get_personal_notes_instructions()
:获取个人笔记使用说明。get_personal_notes(topics, from_date, to_date)
:按标签和日期范围检索个人笔记。get_todo_list(done, from_date, to_date)
:检索待办事项列表。
常见问题解答
- 如何启用 Logseq HTTP API 服务器:
- 打开 Logseq,进入设置 > 高级 > 启用开发者模式和 HTTP API 服务器。
-
设置 API token,需与 MCP 服务器配置中的
LOGSEQ_API_KEY
匹配。 -
调试建议:
- 推荐使用 MCP Inspector 进行调试。
使用教程
使用依赖
- Logseq HTTP API 服务器:
- 确保 Logseq 已安装并运行。
- 启用 HTTP API 服务器并设置 API token。
安装教程
- Claude Desktop 和 Cursor:
- 在配置文件中添加 MCP 服务器配置。
-
示例配置:
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:
- 运行命令:
bash
claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseq
调试方式
- 使用 MCP Inspector:
- 运行命令:
bash
npx @modelcontextprotocol/inspector uv --directory /Users/ronie/MCP/mcp-pkm-logseq run mcp-pkm-logseq - 访问浏览器中显示的 URL 开始调试。