Logseq MCP Tools

Logseq MCP 工具

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

概述

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

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

安装

克隆此仓库
使用 npm、yarn 或 pnpm 安装依赖项：

# 使用 npm
npm install

# 使用 yarn
yarn install

# 使用 pnpm
pnpm install

复制环境模板并配置您的 Logseq 令牌：

cp .env.template .env
# 使用您的 Logseq 身份验证令牌编辑 .env

配置

本项目包含一个 .env.template 文件，您可以复制并重命名为 .env。

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

打开 Logseq
在“设置”>“功能”>“启用 HTTP API”中启用 HTTP API
在“设置”>“功能”>“HTTP API 身份验证令牌”中设置您的身份验证令牌

用法

运行 MCP 服务器

可以使用以下命令启动服务器：

# 使用 npm 脚本
npm start

# 或者直接使用 tsx
npx tsx index.ts

与 Claude 连接

Claude 桌面版

按照 Claude MCP 快速入门指南进行操作：

重要提示：通过 Homebrew（或其他方式）全局安装 Node.js：

brew install node

安装 Claude 桌面应用程序
打开 Claude 菜单并选择“设置...”
单击左侧边栏中的“开发者”，然后单击“编辑配置”
这将打开您的 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）

保存文件并重启 Claude 桌面版

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

"Show me my recent journal entries" (显示我最近的日记条目)
"Summarize my notes from last week" (总结我上周的笔记)
"Find all pages related to [topic]" (查找所有与 [主题] 相关的页面)

Cursor 中的 Claude

按照 Cursor MCP 文档进行操作：

打开 Cursor
从设置中添加一个新的 MCP 服务
输入以下命令：

npx tsx "/path/to/index.ts"

为您的服务命名，例如“Logseq Tools”

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

Anthropic API 中的 Claude (通用)

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

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

可用工具

getAllPages

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

getPage

获取特定页面的内容。

参数：

pageName: 要检索的页面的名称

getJournalSummary

生成指定日期范围内的日记条目摘要。

参数：

dateRange: 自然语言日期范围，如“today”（今天）、“this week”（本周）、“last month”（上个月）、“this year”（今年）等。

此工具将：

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

createPage

在您的 Logseq 图谱中创建一个新页面。

参数：

pageName: 新页面的名称
content: (可选) 页面的初始内容

searchPages

按名称搜索页面。

参数：

query: 用于按名称过滤页面的搜索查询

getBacklinks

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

参数：

pageName: 要查找反向链接的页面名称

analyzeGraph

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

参数：

daysThreshold: (可选) 回溯“最近”内容的天数（默认值：30）

功能：

识别经常引用的页面
跟踪最近的更新
发现页面集群和连接
列出未完成的任务
建议可能需要的更新

findKnowledgeGaps

分析您的知识图谱以识别潜在的差距和需要改进的领域。

参数：

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

功能：

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

analyzeJournalPatterns

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

参数：

timeframe: (可选) 要分析的时间段（例如，“last 30 days”（过去 30 天）、“this year”（今年））
includeMood: (可选) 如果存在，则分析情绪模式（默认值：true）
includeTopics: (可选) 分析主题模式（默认值：true）

功能：

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

smartQuery

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

参数：

request: 您要查找的内容的自然语言描述
includeQuery: (可选) 在结果中包含生成的 Datalog 查询
advanced: (可选) 使用高级分析功能

功能：

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

suggestConnections

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

参数：

minConfidence: (可选) 建议的最小置信度分数（0-1，默认值：0.6）
maxSuggestions: (可选) 要返回的最大建议数（默认值：10）
focusArea: (可选) 围绕其集中建议的主题或领域

功能：

发现页面之间潜在的连接
识别知识综合机会
根据最近的兴趣建议探索路径
提供建议的置信度分数

开发

服务器使用以下技术构建：

Model Context Protocol TypeScript SDK
Zod 用于参数验证
Logseq HTTP API 用于数据访问

要使用新工具进行扩展，请在 index.ts 中添加额外的 server.tool() 定义。

故障排除

常见问题

Node.js 版本管理器 (fnm, nvm 等)

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

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

brew install node

这确保了所有应用程序（包括 Claude 桌面版）都可以使用 Node.js。

基本故障排除步骤

确保 Logseq 正在运行并启用了 HTTP API
验证 .env 中的身份验证令牌与 Logseq 中设置的令牌匹配
检查 Claude 配置中 index.ts 文件的路径是否正确
尝试直接在终端中运行 npx tsx index.ts 以验证它是否有效

在 Claude 桌面版中查看日志

实时监控日志：

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

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