Logseq MCP Server

与Logseq知识库直接集成的Model Context Protocol服务器。此服务器使LLMs能够与Logseq图进行交互，创建页面，管理块，并以编程方式组织信息。

<a href="https://glama.ai/mcp/servers/@dailydaniel/logseq-mcp"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1920902478,2891433659&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Logseq Server MCP server" /> </a>

在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"
      }
    }
  }
}

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

{
  "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

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
- 优先级：高

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

为今天创建日志条目，初始内容如下：
- 早会已完成
- 开始处理新的认证系统

调试

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

贡献

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

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