# apw124
## 基本信息
- Slug: `apw124-logseq-mcp`
- Source: modelscope
- Publisher: @apw124/logseq-mcp
- Categories: knowledge-and-memory / note-taking / agent-orchestration
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@apw124/logseq-mcp
## 简介
暂无描述。
## MCP Server 详情

# Logseq MCP 工具

该项目提供了一组模型上下文协议（MCP）工具，使AI代理能够与您的本地Logseq实例进行交互。

## 安装

1. 确保已安装Python 3.11+
2. 克隆此仓库
3. 安装依赖项：
   bash
   pip install -e .
   

## 设置

1. 确保您的Logseq已启用API。
   - 在Logseq中，转到设置 > 高级 > 开发者模式 > 启用开发者模式
   - 然后，转到插件 > 打开Logseq开发者插件
   - 还需在高级设置中设置一个API令牌
   - 重启Logseq

2. 在您的Cursor MCP配置文件（通常位于`~/.cursor/mcp.json`）中配置MCP服务器：
   json
   {
     "mcpServers": {
       "logseq": {
         "command": "/opt/homebrew/bin/uvx",
         "args": ["logseq-mcp"],
         "env": {
           "LOGSEQ_API_URL": "http://localhost:12315",
           "LOGSEQ_TOKEN": "your-token-here"
         }
       }
     }
   }
   
或者

3. 使用以下命令通过Claude Code配置MCP服务器：

claude mcp add

- 选择范围
- 选择Stdio
- `LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp`

## 与Cursor和Claude一起使用

### 添加到Cursor的MCP工具

1. 按照上面设置部分所示配置MCP服务器

2. 打开Cursor并转到MCP面板（侧边栏）

3. Logseq工具应出现在您可用工具的列表中

### 与Claude一起使用

当在Cursor中使用Claude时，您需要通过类似以下提示告知它您可以访问Logseq工具：

“您可以访问Logseq工具，这些工具可以帮助您与我的Logseq图谱进行交互。您可以使用如logseq.get_all_pages()、logseq.get_page(name)、logseq.create_page(name)等功能。”

## 可用工具

所有工具都在`logseq`命名空间下可用：

### 页面
- `logseq.get_all_pages`: 获取Logseq图谱中的所有页面列表
- `logseq.get_page`: 按名称获取特定页面
- `logseq.create_page`: 创建新页面
- `logseq.delete_page`: 删除页面及其所有块

### 块
- `logseq.get_page_blocks`: 从特定页面获取所有块
- `logseq.get_block`: 按ID获取特定块
- `logseq.create_block`: 在页面上创建新块
- `logseq.insert_block`: 将块作为另一个块的子块插入
- `logseq.update_block`: 更新现有块
- `logseq.move_block`: 将块移动到不同位置
- `logseq.remove_block`: 移除块及其所有子块
- `logseq.search_blocks`: 搜索与查询匹配的块

## 使用Logseq

### 日记页面

Logseq中的日记页面具有特定格式和属性：

1. 创建或访问日记页面时，请使用"mmm dth, yyyy"格式（例如："Apr 4th, 2025"）
2. 日记页面由Logseq自动按正确的日期格式化
3. 日记页面具有由Logseq自动设置的特殊属性：
   - `journal?`: true - 表示这是一个日记页面
   - `journalDay`: YYYYMMDD - 数字格式的日期（例如，2025年4月4日为20250404）
4. 示例：`await logseq.create_page("Apr 4th, 2025")`

**重要提示：** 您无需手动设置`journal?`或`journalDay`属性。只需以正确的日期格式（例如"Apr 4th, 2025"）创建页面，即可自动将其配置为带有适当属性的日记页面。

### 块结构和格式

Logseq中的块有一些重要的特性需要了解：

1. **自动项目符号**：所有块在Logseq UI中都会自动呈现为项目符号
2. **页面链接**：使用双括号创建链接：`[[页面名称]]`
3. **层次结构块**：
   - 块结构数据包含层次信息：
     - `parent`: 父块的ID
     - `level`: 缩进级别（顶级为1，缩进块为2+）
     - `left`: 左侧的块（通常是缩进块的父块）

4. **块内容**：创建块时，可以包括文本格式：- 基本的 Markdown 格式是支持的（如加粗、斜体等）
- 代码块内的项目符号列表可能支持有限
- 多行内容是支持的，但可能会受到 Logseq 解析规则的影响

5. **日记块**: 在日记页面中创建的块继承了特殊属性：
   - `journal?`: true
   - `journalDay`: YYYYMMDD - 与日记页面相同

**注意:** 就像日记页面一样，这些块属性由 Logseq 自动处理。在日记页面上创建块时，不需要手动设置 `journal?` 或 `journalDay` 属性。

### 常见任务示例用法

**使用 Cursor 代理:**
当您在 Cursor 中配置了 Logseq MCP 工具后，可以给代理提供如下提示：

- "创建一个名为 'Meeting Notes' 的新页面，并添加今天的议程作为项目符号"
- "在我的日记页面中添加今天的任务，并将其放在 'Tasks' 部分"
- "更新今天的日记条目，添加 [[Project Plan]]，并将其子元素设置为 'Completed milestone 1'"
- "在我的图谱中搜索关于 'python projects' 的块，并将它们组织到一个新的页面上"

代理将使用适当的 Logseq 工具来执行这些操作。