MCP Logseq Server

🚀 LogSeq 的 MCP 服务器

本项目是一个 MCP 服务器，旨在通过 API 与 LogSeq 进行交互，为用户提供便捷的操作方式，高效处理 LogSeq 中的各种数据。

✨ 主要特性

该服务器实现了多个实用工具，可用于与 LogSeq 进行交互，具体如下：

• list_graphs：列出所有可用图。
• list_pages：列出当前图中的所有页面。
• get_page_content：返回单个页面的内容。
• search：在所有页面中搜索内容。
• create_page：创建新页面。
• update_page：更新现有页面的内容。
• delete_page：删除页面。

示例提示

建议先指示克劳德使用 LogSeq，之后它便会持续调用这些工具。以下是一些示例提示：

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

📦 安装指南

LogSeq API 配置

您可以通过以下两种方式配置环境变量与 LogSeq API 设置：

1. 添加到服务器配置（推荐）

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

2. 在工作目录中创建 .env 文件 在工作目录中创建一个 .env 文件，并包含所需的变量：

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

💻 使用示例

基础用法

目前文档未给出基础使用的代码示例，待补充相关代码后可进行展示。

高级用法

目前文档未给出高级使用的代码示例，待补充相关代码后可进行展示。

🔧 技术细节

构建

若要准备分发包，需按以下步骤操作：

1. 同步依赖项并更新锁定文件：

uv sync

调试

由于 MCP 服务器通过 stdio 运行，调试工作可能具有一定挑战性。为了获得最佳的调试体验，我们推荐使用 MCP Inspector。 您可以通过以下命令启动 MCP Inspector：

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