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