Logseq MCP Tools

🚀 Logseq MCP 工具

這是一個基於 Model Context Protocol (MCP) 的服務器，藉助 AI 助手，可對 Logseq 知識圖譜進行結構化訪問。它能讓 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 調試文檔。