MCP 服务器用于 LogSeq

通过其 API 与 LogSeq 进行交互的 MCP 服务器。

组件

工具

服务器实现了多个工具来与 LogSeq 交互：

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

示例提示

最好先指示 Claude 使用 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"
    }
  }
}

1. 在工作目录中创建一个带有必需变量的 .env 文件：

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

开发

构建

要准备分发包，请执行以下操作：

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

uv sync

调试

由于 MCP 服务器通过 stdio 运行，调试可能会比较困难。为了获得最佳调试体验，我们建议使用 MCP Inspector。

您可以使用 npm 启动 MCP Inspector：

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