mcp-pkm-logseq MCP服务器

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

组件

资源

• 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"）

快速开始

安装

Claude Desktop 和 Cursor

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

<details> <summary>已发布的服务器配置</summary>

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

</details>

Claude Code

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密钥（这应该与MCP服务器配置中的LOGSEQ_API_KEY值匹配）

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

创建MCP PKM Logseq页面

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

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

此页面将在AI认为需要理解用户时显示。

开发

构建和发布

为了准备分发包：

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

uv sync

2. 构建包分布：

uv build

这将在dist/目录中创建源代码和轮子分布。

3. 发布到PyPI：

uv publish

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

• Token: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过标准I/O运行，调试可能会很困难。为了获得最佳的调试体验，我们强烈建议使用MCP Inspector。

您可以使用以下命令通过npm启动MCP Inspector：

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

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

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

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