这个项目提供了一套模型背景协议(MCP)工具,使AI代理能够与您本地的Logseq实例互动.

□ 安装

1. 确保安装 Python 3.11+
2. 克隆此存储器
3. 安装依赖:

□ 设置

1. 确定您的日志已启用 API 。

• 在日志中,请访问设置 > 高级 > 开发者模式 > 启用开发者模式
• 然后,转到插件 > 打开日志开发者插件
• 在高级设置中设置 API 令牌
• 重新启动日志

2. 在您的 Cursor MCP 配置文件中配置 MCP 服务器( 通常在 [[T0] ) :

或

3. 配置 Claude 代码以使用 MCP 服务器:

• 选择范围
• 选择斯特迪奥
• [[T1]

□ 用克苏和克劳德

QQ 添加到光标的 MCP 工具

1. 配置上所显示的 MCP 服务器

2. 打开光标并进入 MCP 面板(侧边栏)

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

使用克劳德

在 Cursor 中使用 Claude 时,您需要告知它您有类似 :

Logseq MCP Tools

This project provides a set of Model Context Protocol (MCP) tools that enable AI agents to interact with your local Logseq instance.

Installation

1. Ensure you have Python 3.11+ installed
2. Clone this repository
3. Install dependencies:

   pip install -e .
   

Setup

1. Make sure your Logseq has the API enabled.

   • In Logseq, go to Settings > Advanced > Developer mode > Enable Developer mode
   • Then, go to Plugins > Turn on Logseq Developer Plugin
   • Also set an API token in the Advanced settings
   • Restart Logseq

2. Configure the MCP server in your Cursor MCP configuration file (typically at ~/.cursor/mcp.json):

   {
     "mcpServers": {
       "logseq": {
         "command": "/opt/homebrew/bin/uvx",
         "args": ["logseq-mcp"],
         "env": {
           "LOGSEQ_API_URL": "http://localhost:12315",
           "LOGSEQ_TOKEN": "your-token-here"
         }
       }
     }
   }
   

OR

3. Configure Claude Code to use the MCP server with:

claude mcp add

• Select scope
• Select Stdio
• LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp

Using with Cursor and Claude

Adding to Cursor’s MCP Tools

1. Configure the MCP server as shown above in the Setup section

2. Open Cursor and go to the MCP panel (sidebar)

3. The Logseq tool should appear in your list of available tools

Using with Claude

When using Claude in Cursor, you’ll need to inform it that you have Logseq tools available with a prompt similar to:

“You have access to Logseq tools that can help you interact with my Logseq graph. You can use functions like logseq.get_all_pages(), logseq.get_page(name), logseq.create_page(name), etc.”

Available Tools

All tools are available under the logseq namespace:

Pages

• logseq.get_all_pages: Get a list of all pages in the Logseq graph
• logseq.get_page: Get a specific page by name
• logseq.create_page: Create a new page
• logseq.delete_page: Delete a page and all its blocks

Blocks

• logseq.get_page_blocks: Get all blocks from a specific page
• logseq.get_block: Get a specific block by ID
• logseq.create_block: Create a new block on a page
• logseq.insert_block: Insert a block as a child of another block
• logseq.update_block: Update an existing block
• logseq.move_block: Move a block to a different location
• logseq.remove_block: Remove a block and all its children
• logseq.search_blocks: Search for blocks matching a query

Working with Logseq

Journal Pages

Journal pages in Logseq have a specific format and attributes:

1. Use the format “mmm dth, yyyy” (e.g., “Apr 4th, 2025”) when creating or accessing journal pages
2. Journal pages are automatically formatted by Logseq with proper dating
3. Journal pages have special attributes that are automatically set by Logseq:
   • journal?: true - Indicates this is a journal page