金大哥 - LogSeq MCP 详情

article

README

🚀 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 (布尔值): 以页面级别块形式创建；before (布尔值): 在父块之前插入；custom_uuid (字符串): 自定义的 UUIDv4 | | logseq_edit_block | 进入块编辑模式 | src_block (字符串, 必填): 块 UUID；pos (数字): 光标位置 | | logseq_exit_editing_mode | 退出编辑模式 | select_block (布尔值): 保持块选中状态 |

页面操作

| 工具名称 | 功能 | 参数 | | ---- | ---- | ---- | | logseq_create_page | 创建新页面 | page_name (字符串, 必填): 页面名称；properties (对象): 页面属性；journal (布尔值): 设为日志页面；format (字符串): 页面格式 (Markdown/org) | | logseq_get_page | 获取页面详情 | src_page (字符串, 必填): 页面标识符；include_children (布尔值): 包含子块 | | logseq_get_all_pages | 列出所有页面 | repo (字符串): 存储库名称 |

内容检索

| 工具名称 | 功能 | 参数 | | ---- | ---- | ---- | | logseq_get_current_page | 获取活动页面/块 | 无 | | logseq_get_current_blocks_tree | 当前页面的块层次结构 | 无 | | logseq_get_editing_block_content | 获取活动块内容 | 无 | | logseq_get_page_blocks_tree | 获取页面的块结构 | src_page (字符串, 必填): 页面标识符 |

提示语

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 端点 (页面链接、查询支持)
改进块操作功能
添加模板支持
增强错误处理

LogSeq