AI导哈

个人知识管理服务器

一个用于与Logseq个人知识管理系统交互的MCP服务器，支持自定义指令和笔记检索功能。

  • by ruliana
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 ruliana/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检查器 npm 使用此命令：

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",
      "/<parent-directories>/mcp-pkm-logseq",
      "run",
      "mcp-pkm-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "your-logseq-api-token",
      "LOGSEQ_URL": "http://localhost:12315"
    }
  }
}

相关 MCP