Logseq Mcp Tools

🚀 Logseq MCP 工具

这是一个基于 Model Context Protocol (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
3. 在“设置”>“功能”>“HTTP API 认证令牌”中设置你的认证令牌

使用方法

运行 MCP 服务器

服务器可以通过以下命令启动：

# 使用 npm 脚本
npm start

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

在 Claude Desktop 中配置

1. 打开 Claude Desktop 的首选项。
2. 添加一个新的 MCP 工具：
   • 名称：logseq-mcp
   • 可执行文件路径：/Applications/Claude Desktop.app/Contents/Frameworks/node.js（macOS）或 C:\Program Files\Claude Desktop\node.exe（Windows）
   • 参数：--port 3000（根据你的服务器端口调整）

开发

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

• Model Context Protocol TypeScript SDK
• Zod 进行参数验证
• Logseq HTTP API 访问数据

要添加新的工具，请在 index.ts 中定义额外的 server.tool() 方法。

常见问题

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 中设置的令牌一致
• 检查配置中指向 index.ts 文件的路径是否正确
• 尝试在终端直接运行 npx tsx index.ts 以验证其正常工作

在 Claude Desktop 中查看日志

实时监控日志：

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

如需更详细的调试信息，请参考 官方 MCP 调试文档。