Logseq

🚀 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": "<YOUR_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": "<YOUR_KEY>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

💻 使用示例

基礎用法

以下是使用 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"
      }
    }
  }
}

高級用法

在配置完成並啟動服務器後，可以使用服務器提供的工具進行各種操作，如塊操作、頁面操作和內容檢索等。

📚 詳細文檔

可用工具

塊操作

頁面操作

內容檢索

提示語

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 端點 (頁面鏈接、查詢支持)
• 改進塊操作功能
• 添加模板支持
• 增強錯誤處理