dailydaniel

@dailydaniel/logseq-mcp

0 Stars 367 次浏览 dailydaniel 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "logseq": {
      "args": [
        "mcp-server-logseq==0.0.1"
      ],
      "command": "uvx",
      "env": {
        "LOGSEQ_API_TOKEN": "\u003cYOUR_KEY\u003e",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

服务介绍

Logseq MCP 服务器

这是一个提供与 Logseq 知识库直接集成的 Model Context Protocol 服务器。该服务器使 LLMs 能够与 Logseq 图谱交互，创建页面，管理块，并以编程方式组织信息。

与 Claude Desktop 一起使用

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

如果遇到错误，请使用 0.0.1 版本：

json
{
"mcpServers": {
"logseq": {
"command": "uvx",
"args": ["mcp-server-logseq==0.0.1"],
"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

创建一个新的 Logseq 页面
参数:

page_name: 页面名称
properties: 作为 JSON 的页面属性
journal: 对于日记页面设置为 true

安装

使用 pip

bash
pip install mcp-server-logseq

从源代码安装

bash
git clone https://github.com/dailydaniel/logseq-mcp.git
cd logseq-mcp
cp .env.example .env
uv sync

运行服务器：
bash
python -m mcp_server_logseq

配置

API 密钥

在 Logseq 中生成 API 令牌: API → 授权令牌
设置环境变量：
bash
export LOGSEQ_API_TOKEN=your_token_here

或者通过命令行传递：
bash
python -m mcp_server_logseq --api-key=your_token_here

图配置

默认 URL: http://localhost:12315
要自定义：
bash
python -m mcp_server_logseq --url=http://your-logseq-instance:port

示例

创建会议笔记页面

plaintext
创建新页面 "Team Meeting 2024-03-15" 并带有以下属性：

标签: #meeting #engineering
参与者: Alice, Bob, Charlie
状态: 待定

向现有页面添加任务块

plaintext
向 [[Project Roadmap]] 添加任务：

完成 API 文档
截止日期: 2024-03-20
优先级: 高

创建带有初始块的日记条目

plaintext
为今天创建日记条目并带有初始内容：

早上站立会议完成
开始处理新的认证系统## 调试
bash
npx @modelcontextprotocol/inspector uv --directory . run mcp-server-logseq

贡献

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

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

查看源码项目主页