Logseq MCP Tools

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

概述

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

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

安装

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

# 使用npm
npm install

# 使用yarn
yarn install

# 使用pnpm
pnpm install

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

cp .env.template .env
# 编辑.env文件以包含您的Logseq认证令牌

配置

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

您可以在以下位置找到您的Logseq认证令牌：

1. 打开Logseq
2. 在设置 > 功能 > 启用HTTP API中启用HTTP API
3. 在设置 > 功能 > HTTP API认证令牌中设置您的认证令牌

使用方法

运行MCP服务器

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

# 使用npm脚本
npm start

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

与Claude连接

Claude桌面版

遵循Claude MCP快速入门指南：

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

brew install node

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

6. 保存文件并重新启动Claude桌面版

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

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

Claude在Cursor中

遵循Cursor MCP文档：

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

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

4. 给您的服务命名，如“Logseq Tools”

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

Claude在Anthropic API（通用）

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

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

可用工具

getAllPages

获取Logseq图中的所有页面列表。

getPage

获取特定页面的内容。

参数：

• pageName：要检索的页面名称

getJournalSummary

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

参数：

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

此工具将：

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

createPage

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

参数：

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

searchPages

按名称搜索页面。

参数：

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

getBacklinks

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

参数：

• pageName：要查找回链的页面名称

analyzeGraph

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

参数：

• daysThreshold：（可选）查看“近期”内容的天数（默认：30）

功能：

• 标识频繁引用的页面
• 跟踪最近更新
• 发现页面集群和连接
• 列出待办事项
• 建议可能需要的更新

findKnowledgeGaps

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

参数：

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

功能：

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

analyzeJournalPatterns

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

参数：

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

功能：

• 主题趋势和发展
• 情绪模式分析
• 习惯跟踪统计数据
• 项目进度跟踪

smartQuery

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

参数：

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

功能：

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

suggestConnections

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

参数：

• minConfidence：（可选）建议的最低置信度分数（0-1，默认：0.6）
• maxSuggestions：（可选）返回的最大建议数量（默认：1 0）
• focusArea：（可选）围绕某个主题或区域进行建议

功能：

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

开发

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

• 模型上下文协议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

这确保了Node.js对所有应用程序都可用，包括Claude桌面版。

基础故障排除步骤

• 确保Logseq已运行且启用了HTTP API
• 验证.env文件中的auth令牌与Logseq中设置的一致
• 检查Claude配置中指向您的index.ts文件的路径是否正确
• 尝试直接在终端中运行npx tsx index.ts以验证其是否正常工作

在Claude桌面版中查看日志

实时监控日志：

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

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