Ergut MCP Logseq Server

🚀 LogSeq 的 MCP 服務器

本項目是一個 MCP 服務器，可通過 API 與 LogSeq 進行對接，為用戶提供便捷的交互體驗。

✨ 主要特性

工具

該服務器實現了多個實用工具，用於與 LogSeq 進行交互：

• list_graphs：列出所有可用圖表。
• list_pages：列出當前圖表中的所有頁面。
• get_page_content：返回單個頁面的內容。
• search：在所有頁面中搜索內容。
• create_page：創建新的頁面。
• update_page：更新現有頁面的內容。
• delete_page：刪除一個頁面。

示例提示

在使用時，首先指示克勞德使用 LogSeq 是個不錯的選擇，之後它將自動調用相應工具。以下是一些示例提示：

• 獲取我最新的會議記錄內容並進行摘要。
• 搜索提到項目 X 的所有頁面並解釋上下文。
• 創建今天的會議記錄新頁面。
• 更新項目的最新狀態頁面。

📦 安裝指南

LogSeq API 配置

你可以通過以下兩種方式配置環境與 LogSeq API 設置：

方式一：添加到服務器配置（推薦）

在服務器配置中添加如下內容：

{
  "mcp-logseq": {
    "command": "uvx",
    "args": [
      "mcp-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "<你的_api_令牌_here>",
      "LOGSEQ_API_URL": "http://localhost:12315"
    }
  }
}

方式二：在工作目錄中創建 .env 文件

在工作目錄中創建一個 .env 文件，幷包含所需的變量：

LOGSEQ_API_TOKEN=your_token_here
LOGSEQ_API_URL=http://localhost:12315

🔧 技術細節

構建

在準備分發包時，需要同步依賴項並更新鎖定文件，可執行以下命令：

uv sync

調試

由於 MCP 服務器通過 stdio 運行，調試可能具有一定挑戰性。為了獲得最佳調試體驗，我們推薦使用 MCP Inspector。你可以通過 npm 啟動 MCP 檢查器，命令如下：

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-logseq run mcp-logseq