金大哥 - logseq-mcp-tools MCP 详情

article

README

🚀 Logseq MCP 工具

这是一个基于 Model Context Protocol (MCP) 的服务器，借助它，AI 助手能够对 Logseq 知识图谱进行结构化访问。

🚀 快速开始

此项目创建了一个 MCP 服务器，允许像 Claude 这样的 AI 助手与你的 Logseq 知识库交互，实现对知识图谱的结构化访问。

✨ 主要特性

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

📦 安装指南

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

# 使用 npm
npm install

# 使用 yarn
yarn install

# 使用 pnpm
pnpm install

复制环境变量模板并配置你的 Logseq 令牌：

cp .env.template .env
# 在.env 中编辑你的 Logseq 认证令牌

📚 详细文档

配置

此项目包括一个 .env.template 文件，你可以复制并重命名为 .env。你可以在 Logseq 中找到你的认证令牌：

打开 Logseq
在“设置”>“功能”中启用 HTTP API
在“设置”>“功能”>“HTTP API 认证令牌”中设置你的认证令牌

使用方法

运行 MCP 服务器

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

# 使用 npm 脚本
npm start

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

在 Claude Desktop 中配置

打开 Claude Desktop 的首选项。
添加一个新的 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 调试文档。

logseq-mcp-tools