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