Logseq MCP Server

Logseq MCP Server

site icon
2025.03.20 16
Python知识管理任务跟踪自动化文档生成开发效率
Logseq MCP Server 是一个模型上下文协议服务器,专门设计用于与 Logseq 知识库直接集成。它使大型语言模型(LLMs)能够以编程方式与 Logseq 图表交互,创建页面,管理块和组织信息。该服务器提供了丰富的块操作、页面操作和内容检索功能,适用于知识管理、任务跟踪和自动化文档生成等场景。
View on GitHub

Overview

基本能力

产品定位

Logseq MCP Server 是一个中间件,旨在桥接大型语言模型和 Logseq 知识库,实现自动化知识管理和内容生成。

核心功能

  • 块操作:包括插入块、编辑块和退出编辑模式等功能。
  • 页面操作:支持创建页面、获取页面详情和列出所有页面。
  • 内容检索:提供获取当前页面、块层次结构和编辑块内容等功能。

适用场景

  • 自动化知识管理
  • 任务跟踪和项目管理
  • 自动化文档生成
  • 个人知识库维护

工具列表

  1. logseq_insert_block:在 Logseq 中创建新块
  2. logseq_edit_block:进入块编辑模式
  3. logseq_exit_editing_mode:退出编辑模式
  4. logseq_create_page:创建新页面
  5. logseq_get_page:获取页面详情
  6. logseq_get_all_pages:列出所有页面
  7. logseq_get_current_page:获取活动页面/块
  8. logseq_get_current_blocks_tree:获取当前页面的块层次结构
  9. logseq_get_editing_block_content:获取活动块的内容
  10. logseq_get_page_blocks_tree:获取页面的块结构

常见问题解答

  • API 密钥:需要在 Logseq 中生成并设置环境变量
  • 图形配置:默认 URL 为 http://localhost:12315,可自定义

使用教程

使用依赖

无特殊依赖,只需 Python 环境。

安装教程

  1. 使用 pip 安装:
pip install mcp-server-logseq
  1. 从源代码安装:
git clone https://github.com/dailydaniel/logseq-mcp.git
cd logseq-mcp
cp .env.example .env
uv sync
  1. 运行服务器:
python -m mcp_server_logseq

配置

  1. API 密钥
export LOGSEQ_API_TOKEN=your_token_here

或通过命令行:

python -m mcp_server_logseq --api-key=your_token_here
  1. 图形配置
python -m mcp_server_logseq --url=http://your-logseq-instance:port

调试方式

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。