MCP Pkm Logseq

mcp-pkm-logseq mcp服务器

MCP服务器，用于使用自定义指令与您的Logseq个人知识管理系统进行交互

组件

资源

• logseq://guide -关于如何与此知识库交互的初步说明

工具

• get_personal_notes_instructions() -获取有关如何使用个人笔记工具的说明
• get_personal_notes(topics, from_date, to_date) -从Logseq中检索标记有指定主题的个人笔记
• 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")

快速启动

安装

克劳德桌面和光标

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

Published Servers Configuration

"mcpServers": {
  "mcp-pkm-logseq": {
    "command": "uvx",
    "args": [
      "mcp-pkm-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "your-logseq-api-token",
      "LOGSEQ_URL": "http://localhost:12315"
    }
  }
}

克劳德代码

claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseq

启动Logseq服务器

Logseq的HTTP API是一个在桌面Logseq应用程序中运行的接口。启用后，它将启动一个本地HTTP服务器（默认端口12315），允许对Logseq知识库进行编程访问。API支持查询页面和块、搜索内容，并可能通过身份验证请求修改内容。

要启用Logseq HTTP API服务器，请执行以下操作：

1. 打开Logseq并转到设置（右上角）
2. 导航到高级
3. 启用“开发人员模式”
4. 启用“HTTP API服务器”
5. 设置API令牌（这应该与 LOGSEQ_API_KEY MCP服务器配置中的值）

有关更多详细说明，请参阅：https://logseq-copilot.eindex.me/doc/setup

创建MCP PKM Logseq页面

在Logseq图中创建一个名为“MCP PKM Logseq”的页面，作为AI助手的指南。添加以下内容：

• 标签系统的描述（例如，哪些标签代表项目、区域、资源）
• 常用标签列表及其涵盖的主题
• 用于组织信息的常见工作流
• 页面和块的命名约定
• 关于您希望如何检索信息的说明
• 用于搜索的有用主题组合示例
• 关于你的个人知识管理方法的任何背景

每当AI认为需要了解用户时，就会显示此页面。

发展

建筑与出版

准备分发包裹：

1. 同步依赖关系并更新锁文件：

uv sync

1. 构建包分发：

uv build

这将在 dist/ 目录。

1. 发布到PyPI：

uv publish

注意：您需要通过环境变量或命令标志设置PyPI凭据：

• 令牌： --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码： --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 使用此命令：

npx @modelcontextprotocol/inspector uv --directory /Users/ronie/MCP/mcp-pkm-logseq run mcp-pkm-logseq

启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。

将开发服务器配置添加到Claude Desktop

"mcpServers": {
  "mcp-pkm-logseq": {
    "command": "uv",
    "args": [
      "--directory",
      "/
/mcp-pkm-logseq",
      "run",
      "mcp-pkm-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "your-logseq-api-token",
      "LOGSEQ_URL": "http://localhost:12315"
    }
  }
}