Logseq MCP 服务器

一个模型上下文协议服务器，提供与 Logseq 知识库的直接集成。此服务器使 LLM 能够与 Logseq 图进行交互，以编程方式创建页面、管理块和组织信息。

与 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

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

• page_name: 页面名称
• properties: 页面属性，JSON 格式
• journal: 设置为 true 以创建日记页面

安装

使用 pip

pip install mcp-server-logseq

从源代码

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

运行服务器:

python -m mcp_server_logseq

配置

API 密钥

1. 在 Logseq 中生成 API 令牌：API → 授权令牌
2. 设置环境变量：

export LOGSEQ_API_TOKEN=your_token_here

或者通过命令行传递：

python -m mcp_server_logseq --api-key=your_token_here

图配置

默认 URL：http://localhost:12315 要自定义：

python -m mcp_server_logseq --url=http://your-logseq-instance:port

示例

创建会议记录页面

创建新页面 "Team Meeting 2024-03-15"，属性如下：
- 标签：#meeting #engineering
- 参与者：Alice, Bob, Charlie
- 状态：pending

将任务块添加到现有页面

将任务添加到 [[Project Roadmap]]：
- [ ] 完成 API 文档
- 截止日期：2024-03-20
- 优先级：high

创建包含第一个块的日记条目

为今天创建日记条目，初始内容如下：
- 晨会已完成
- 开始开发新的身份验证系统

调试

npx @modelcontextprotocol/inspector uv --directory . run mcp-server-logseq

贡献

我们欢迎您为增强 Logseq 集成做出贡献：

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