🚀 Logseq MCP 服务器

Logseq MCP 服务器提供了与 Logseq 知识库的直接集成，借助模型上下文协议 (MCP)，让大语言模型 (LLMs) 可以与 Logseq 图表进行交互，实现创建页面、管理块以及以编程方式组织信息等功能。

🚀 快速开始

配置步骤

安装依赖项

确保安装了以下工具：

pip install --user mcpy uvx

创建 MCP 服务器配置文件

在项目根目录下创建一个 mcp-server-logseq.json 文件，内容如下：

{
  "servers": {
    "logseq": {
      "command": "uvx",
      "args": ["mcp-server-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "<YOUR_LOGSEQ_API_TOKEN>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

启动 MCP 服务器

运行以下命令启动 Logseq MCP 服务器：

uvx run mcp-server-logseq --config=mcp-server-logseq.json

使用 Claude Desktop 的示例配置

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": ["mcp-server-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "<YOUR_KEY>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

💻 使用示例

基础用法

以下是使用 Claude Desktop 的示例配置：

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": ["mcp-server-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "<YOUR_KEY>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

高级用法

在配置完成并启动服务器后，可以使用服务器提供的工具进行各种操作，如块操作、页面操作和内容检索等。

📚 详细文档

可用工具

块操作

页面操作

内容检索

提示语

logseq_insert_block

在 Logseq 中创建一个新块 参数：

• parent_block：父块引用 (页面名称或 UUID)
• content：块内容
• is_page_block：设为 true 以表示页面级别块

logseq_create_page

创建新页面 参数：

• page_name (字符串, 必填)：新页面的名称
• properties (可选)：页面属性，例如 { "property1": "value1", "property2": "value2" }
• journal (可选)：设为 true 以表示日志页面

🔧 贡献指南

我们欢迎贡献以增强 Logseq 集成：

• 添加新的 API 端点 (页面链接、查询支持)
• 改进块操作功能
• 添加模板支持
• 增强错误处理