MCP Logseq Server

MCP Logseq Server 是一个基于 Model Context Protocol（MCP）的工具，旨在通过 API 与 LogSeq 笔记应用进行交互。它提供了一系列功能，帮助用户高效管理笔记内容，包括搜索、创建、更新和删除页面等操作。该工具适用于需要快速检索信息并保持笔记最新状态的用户。

核心功能

MCP Logseq Server 提供了多种 API 工具，用于与 LogSeq 进行交互，具体功能如下：

• list_graphs：列出所有可用的 LogSeq 图谱。
• list_pages：列出当前图谱中的所有页面。
• get_page_content：获取指定页面的内容。
• search：在所有页面中搜索包含特定关键词的内容。
• create_page：创建新的笔记页面。
• update_page：更新现有页面的内容。
• delete_page：删除指定的页面。

安装方法

要使用 MCP Logseq Server，首先需要配置 LogSeq API 的访问信息。可以通过以下两种方式配置环境变量：

方法一：添加到服务器配置（推荐）

{
  "mcp-logseq": {
    "command": "uvx",
    "args": [
      "mcp-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "",
      "LOGSEQ_API_URL": "http://localhost:12315"
    }
  }
}

方法二：创建 .env 文件

在工作目录中创建一个 .env 文件，并添加以下内容：

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

使用方法

配置完成后，可以通过命令行启动服务器并执行相关操作。以下是一些示例提示，帮助您快速上手：

• 获取我最新会议笔记的内容并进行摘要。
• 搜索所有提到项目 X 的页面并解释上下文。
• 创建今天会议笔记的新页面。
• 更新项目的状态页面以显示最新的更新。

使用场景

MCP Logseq Server 适用于以下场景：

• 需要高效管理个人或团队笔记的用户。
• 希望快速检索信息并保持笔记内容最新。
• 希望将 LogSeq 集成到自动化工作流中。

技术细节

若要准备分发包，需同步依赖项并更新锁定文件：

uv sync

由于 MCP 服务器通过 stdio 运行，调试可能具有一定挑战性。推荐使用 MCP Inspector 工具进行调试。启动方式如下：

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

MCP Logseq Server 提供了丰富的 API 操作，帮助用户高效管理 LogSeq 笔记内容，是提升笔记管理效率的有力工具。