LogSeq 的 MCP 服务器

用于通过其 API 与 LogSeq 交互的 MCP 服务器。

组件

工具

该服务器实现了多个工具以与 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 文件，包含所需的变量：

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