🚀 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": "" ,
"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": "" ,
"LOGSEQ_API_URL": "http://127.0.0.1:12315"
}
}
}
}
💻 使用示例
基础用法
以下是使用 Claude Desktop 的示例配置：
{
"mcpServers": {
"logseq": {
"command": "uvx",
"args": ["mcp-server-logseq"],
"env": {
"LOGSEQ_API_TOKEN": "" ,
"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 端点 (页面链接、查询支持)
- 改进块操作功能
- 添加模板支持
- 增强错误处理