AI导哈

Logseq知识图谱AI助手工具

一个提供AI助手结构化访问Logseq知识图谱的Model Context Protocol (MCP)服务器。

  • by joelhooks
  • TypeScript
  • 本地部署
  • 70 星标
  • 更新于
在 GitHub 查看 joelhooks/logseq-mcp-tools

使用说明

Logseq MCP工具

一个模型上下文协议（MCP）服务器，为AI助手提供对Logseq知识图的结构化访问。

概述

该项目创建了一个MCP服务器，允许像Claude这样的AI助手与您的Logseq知识库进行交互。它 提供以下工具：

  • 检索所有页面的列表
  • 从特定页面获取内容
  • 为灵活的日期范围生成日记账摘要
  • 提取链接页面并探索连接

安装

通过Smithery安装

自动安装克劳德桌面版Logseq工具 通过 铁匠铺:

npx -y @smithery/cli install @joelhooks/logseq-mcp-tools --client claude
  1. 克隆此存储库
  2. 使用npm、yarn或pnpm安装依赖项：
# Using npm
npm install

# Using yarn
yarn install

# Using pnpm
pnpm install
  1. 复制环境模板并配置Logseq令牌：
cp .env.template .env
# Edit .env with your Logseq authentication token

配置

该项目包括 .env.template 可以复制和重命名的文件 .env.

您可以通过以下方式找到您的Logseq认证令牌：

  1. 打开Logseq
  2. 在“设置”>“功能”>“启用HTTP API”中启用HTTP API
  3. 在“设置”>“功能”>“HTTP API身份验证令牌”中设置身份验证令牌

用法

运行MCP服务器

服务器可以使用以下方式启动：

# Using the npm script
npm start

# Or directly with tsx
npx tsx index.ts

与克劳德联系

克劳德桌面版

跟随 Claude MCP快速入门指南:

  1. 重要：通过Homebrew（或其他方式）全局安装Node.js：
brew install node
  1. 安装Claude桌面应用程序
  2. 打开克劳德菜单，选择“设置…”
  3. 点击左侧边栏中的“开发人员”，然后点击“编辑配置”
  4. 这将打开您的 claude_desktop_config.json 文件。将其内容替换为：
{
  "mcpServers": {
    "logseq": {
      "command": "npx",
      "args": [
        "tsx",
        "/path/to/your/index.ts"
      ]
    }
  }
}

重要： 替换 /path/to/your/index.ts 随着 精确 index.ts文件的绝对路径（例如。， /Users/username/Code/logseq-mcp-tools/index.ts)

  1. 保存文件并重新启动Claude Desktop

现在，您可以与Claude聊天，并要求它使用您的Logseq数据：

  • “显示我最近的日记条目”
  • “总结我上周的笔记”
  • “查找与[主题]相关的所有页面”

克劳德在光标

跟随 光标MCP文档:

  1. 打开光标
  2. 从设置中添加新的MCP服务
  3. 输入以下命令：
npx tsx "/path/to/index.ts"
  1. 为您的服务命名为“Logseq Tools”

现在，您可以在Cursor中使用Claude和您的Logseq数据。

API中的Claude（通用）

使用Claude API或CLI工具时，您可以使用以下工具添加MCP服务：

claude mcp add "logseq" npx tsx "/path/to/index.ts"

Jetbrains Junie设置

要使用JetBrains Junie运行此项目，请执行以下步骤：

构建Docker镜像：

docker build -t logseq-mcp .
# run in project root

然后将以下配置添加到Junie MCP配置中：

    "logseq": {
      "command": "c:\\Program Files\\Docker\\Docker\\resources\\bin\\docker.exe",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network=host",
        "-e",
        "LOGSEQ_TOKEN=<Your Token>",
        "-e",
        "LOGSEQ_HOST=host.docker.internal",
        "logseq-mcp"
      ]
    }

可用工具

获取所有页面

检索Logseq图中所有页面的列表。

获取页面

获取特定页面的内容。

参数：

  • pageName：要检索的页面的名称

获取日志摘要

生成指定日期范围的日记账分录摘要。

参数：

  • dateRange：自然语言日期范围，如“今天”、“本周”、“上个月”、“今年”等。

此工具将：

  • 收集指定范围内的日记账分录
  • 以可读的方式格式化它们
  • 提取和分析引用的页面/概念
  • 展示最常被引用的概念

创建页面

在Logseq图中创建新页面。

参数：

  • pageName：新页面的名称
  • content：（可选）页面的初始内容

搜索页面

按名称搜索页面。

参数：

  • query：搜索查询以按名称筛选页面

获取反向链接

查找引用特定页面的所有页面。

参数：

  • pageName：查找反向链接的页面名称

analyzeGraph

对你的知识图谱进行全面分析。

参数：

  • daysThreshold：（可选）回顾“最近”内容的天数（默认值：30）

特征：

  • 识别频繁引用的页面
  • 跟踪最近的更新
  • 发现页面簇和连接
  • 列出未完成的任务
  • 建议可能需要的更新

查找知识差距

分析你的知识图谱，找出潜在的差距和需要改进的地方。

参数：

  • minReferenceCount：（可选）要考虑的最小引用（默认值：3）
  • includeOrphans：（可选）在分析中包含孤立页面（默认值：true）

特征：

  • 识别经常被引用的缺失页面
  • 查找需要扩展的未开发页面
  • 列出没有传入链接的孤立页面
  • 提供摘要统计信息

分析日志模式

分析日记条目随时间变化的模式。

参数：

  • timeframe：（可选）分析时间段（例如，“过去30天”、“今年”）
  • includeMood：（可选）分析情绪模式（如果存在）（默认值：true）
  • includeTopics：（可选）分析主题模式（默认值：true）

特征：

  • 主题趋势和演变
  • 情绪模式分析
  • 习惯跟踪统计
  • 项目进度跟踪

smartQuery

使用Logseq的DataScript功能执行自然语言查询。

参数：

  • request：您想要查找的内容的自然语言描述
  • includeQuery：（可选）在结果中包含生成的数据日志查询
  • advanced：（可选）使用高级分析功能

特征：

  • 页面连接和关系
  • 内容聚类
  • 任务进度分析
  • 概念演变跟踪

建议连接

使用AI分析您的图表并建议有趣的连接。

参数：

  • minConfidence：（可选）建议的最低置信度得分（0-1，默认值：0.6）
  • maxSuggestions：（可选）要返回的最大建议数（默认值：10）
  • focusArea：（可选）建议关注的主题或领域

特征：

  • 发现页面之间的潜在联系
  • 识别知识综合机会
  • 根据近期兴趣提出探索路径
  • 为建议提供信心评分

发展

服务器是使用以下方式构建的：

  • 模型上下文协议TypeScript SDK
  • Zod用于参数验证
  • 用于数据访问的Logseq HTTP API

要使用新工具进行扩展，请添加其他工具 server.tool() 定义在 index.ts.

故障排除

常见问题

Node.js版本管理器（fnm、nvm等）

如果你使用的是像fnm或nvm这样的Node.js版本管理器，Claude Desktop将无法访问Node.js二进制文件 因为它在修改了PATH的shell环境之外运行。

解决方案：使用Homebrew安装系统范围的Node.js：

brew install node

这确保了Node.js可用于所有应用程序，包括Claude Desktop。

基本故障排除步骤

  • 确保Logseq在启用HTTP API的情况下运行
  • 在中验证您的身份验证令牌 .env 与Logseq中的设置相匹配
  • 检查Claude配置中index.ts文件的路径是否正确
  • 试着跑步 npx tsx index.ts 直接在您的终端中验证它是否正常工作

在Claude Desktop中查看日志

实时监控日志：

# macOS
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

有关更详细的调试信息，请参阅 这 MCP官方调试文档.

相关 MCP