mcp-pkm-logseq MCP server

基本能力

产品定位

mcp-pkm-logseq 是一个专为 Logseq 个人知识管理系统设计的 MCP 服务器，旨在通过程序化方式与用户的 Logseq 知识库进行交互，提高知识管理和检索效率。

核心功能

1. 获取个人笔记指令：提供如何使用个人笔记工具的指导。
2. 检索个人笔记：根据指定标签和日期范围从 Logseq 中检索个人笔记。
3. 获取待办事项列表：从 Logseq 中检索待办事项列表，支持按完成状态和日期范围筛选。

适用场景

1. 个人知识管理：帮助用户高效管理和检索个人笔记。
2. 任务管理：通过程序化方式管理待办事项，提高任务跟踪效率。
3. AI辅助：为AI助手提供结构化访问个人知识库的能力。

工具列表

1. get_personal_notes_instructions()：获取个人笔记使用说明。
2. get_personal_notes(topics, from_date, to_date)：按标签和日期范围检索个人笔记。
3. get_todo_list(done, from_date, to_date)：检索待办事项列表。

常见问题解答

1. 如何启用 Logseq HTTP API 服务器：
2. 打开 Logseq，进入设置 > 高级 > 启用开发者模式和 HTTP API 服务器。

3. 设置 API token，需与 MCP 服务器配置中的 LOGSEQ_API_KEY 匹配。

4. 调试建议：

5. 推荐使用 MCP Inspector 进行调试。

使用教程

使用依赖

1. Logseq HTTP API 服务器：
2. 确保 Logseq 已安装并运行。
3. 启用 HTTP API 服务器并设置 API token。

安装教程

1. Claude Desktop 和 Cursor：
2. 在配置文件中添加 MCP 服务器配置。

3. 示例配置： json "mcpServers": { "mcp-pkm-logseq": { "command": "uvx", "args": ["mcp-pkm-logseq"], "env": { "LOGSEQ_API_TOKEN": "your-logseq-api-token", "LOGSEQ_URL": "http://localhost:12315" } } }

4. Claude Code：

5. 运行命令： bash claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseq

调试方式

1. 使用 MCP Inspector：
2. 运行命令： bash npx @modelcontextprotocol/inspector uv --directory /Users/ronie/MCP/mcp-pkm-logseq run mcp-pkm-logseq
3. 访问浏览器中显示的 URL 开始调试。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。