/ 目錄 / 演練場 / mcp-logseq
● 社群 ergut ⚡ 即開即用

mcp-logseq

作者 ergut · ergut/mcp-logseq

讓你的 Logseq 圖譜可被 AI 查詢——透過 Logseq 本地 HTTP API 讀取頁面、建立區塊、依屬性搜尋、執行 DSL 查詢。

ergut 開發的 mcp-logseq 將 MCP 客戶端連接至 Logseq 的本地 HTTP API。16 個核心工具涵蓋頁面、區塊、命名空間、反向連結與 DSL 查詢。可選的向量搜尋功能可在整個圖譜中進行語意回溯。

為什麼要用

核心特性

即時演示

實際使用效果

logseq.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "logseq",
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "logseq": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-logseq"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add logseq -- uvx mcp-logseq

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: mcp-logseq

根據本週內容草擬今日日誌

👤 Logseq 進階使用者 ⏱ ~10 min beginner

何時使用: 週五回顧時,想要一份本週日誌頁面的摘要。

前置條件
  • 已啟用 HTTP API 的 Logseq — 前往「設定 > 功能 > 啟用 HTTP APIs」並產生 API 金鑰
  • LOGSEQ_API_TOKEN + LOGSEQ_API_URL 環境變數 — 在 MCP 客戶端設定中設定
步驟
  1. 取得上週的日誌頁面
    取得本週每日日誌頁面的內容(從週一到今天)。✓ 已複製
    → 每天的頁面內容
  2. 摘要並草擬
    摘要本週主題,並草擬含有「週回顧」章節的今日日誌。✓ 已複製
    → 可直接貼上的草稿
  3. 寫回頁面
    更新今日日誌頁面,附加「週回顧」章節。✓ 已複製
    → 頁面已更新

結果: 以最少的輸入完成一週的收尾反思。

注意事項
  • 以 append 模式使用 update_page 重試時會產生重複內容 — 對需要冪等操作的情況使用 replace 模式,或先確認現有內容
  • 敏感標籤洩漏至摘要中 — 設定 LOGSEQ_EXCLUDE_TAGS=private,#secret 來隱藏這些頁面

依屬性找出頁面以進行任務掃描

👤 使用任務風格頁面的 Logseq 使用者 ⏱ ~15 min beginner

何時使用: 你用 status:: active 標記專案頁面,並想列出清單。

步驟
  1. 依屬性查詢
    find_pages_by_property: status=active。回傳名稱與更新時間。✓ 已複製
    → 頁面清單
  2. 分類整理
    對每個頁面,取得其內容並告訴我最後 3 個區塊——是否有明確的下一步行動?✓ 已複製
    → 每個頁面的狀態

結果: 掃描所有進行中的專案並找出明確的下一步行動。

在整個圖譜中進行語意回溯

👤 擁有大型 Logseq 圖譜的研究人員 ⏱ ~10 min intermediate

何時使用: 關鍵字搜尋找不到你確定曾寫過的筆記。

前置條件
  • 向量資料庫已同步 — 執行一次 sync_vector_db;大量匯入後重新執行
步驟
  1. 向量搜尋
    vector_search: '我對 test pyramid 與 honeycomb 有什麼筆記?'✓ 已複製
    → 排序後的符合結果
  2. 取得完整頁面
    對最符合的結果執行 get_page_content。✓ 已複製
    → 完整內容

結果: 以語意而非精確關鍵字找到筆記。

將會議頁面轉換為可追蹤的行動項目

👤 專案經理與團隊主管 ⏱ ~10 min beginner

何時使用: 你在 Logseq 中記錄會議內容,並想將行動項目分離出來。

步驟
  1. 讀取會議頁面
    取得 'Meeting/2026-04-14/engineering-sync' 的 get_page_content。✓ 已複製
    → 會議記錄
  2. 擷取行動項目
    找出具有 TODO 性質的條目。對每個項目,在今日日誌下方建立子區塊,包含負責人與截止日期。✓ 已複製
    → 區塊已建立

結果: 將行動項目從筆記中提取出來,整理成可追蹤的清單。

組合

與其他 MCP 搭配,撬動十倍槓桿

logseq + marm-systems

短期記憶用 MARM;持久筆記存入 Logseq

將這些 MARM 情境記錄移入 Logseq,存為 /Notes/2026-04 下的頁面。✓ 已複製
logseq + filesystem

將精選的 Logseq 頁面匯出為 Markdown 檔案

將所有標記 #public 的頁面匯出至 ./exports/public-notes/,每個頁面存為獨立的 .md 檔案。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list_pages (none) 圖譜總覽 free (local API)
get_page_content name: str 讀取頁面 free
create_page name, content, properties? 建立新頁面 free (write)
update_page name, content, mode: append|replace 編輯現有頁面 free (write)
delete_page name: str 破壞性操作——請確認 free
search query: str 全文搜尋 free
query dsl: str Logseq DSL 查詢 free
find_pages_by_property key: str, value?: str 依屬性篩選 free
get_page_backlinks name: str 查詢誰連結了這則筆記 free
insert_nested_block parent_uuid, content, position: child|sibling 新增結構化內容 free (write)
vector_search query: str 語意回溯 free (local embeddings)

成本與限制

運行它的成本

API 配額
無限制——Logseq 的本地 API 沒有用量上限
每次呼叫 Token 數
列表與搜尋用量少;頁面內容可能較長
費用
免費
提示
若圖譜超過 10,000 頁,建議每晚同步向量資料庫,而非每次查詢時才同步。

安全

權限、密鑰、影響範圍

憑證儲存: LOGSEQ_API_TOKEN 存於環境變數中
資料出站: 所有資料均存於 Logseq 本地;向量嵌入保留在本機上
切勿授予: Exposing Logseq's HTTP API to your LAN without firewalling

故障排查

常見錯誤與修復

Connection refused on localhost:12315

點擊 Logseq 中的插頭圖示啟動 HTTP API,預設為關閉狀態。

驗證: curl http://localhost:12315
401 on API calls

金鑰遺失或不符。請至 Logseq 的「Authorization tokens」重新產生。

驗證: Check token in Logseq settings
vector_search empty

請先執行 sync_vector_db;向量資料庫不會自動同步。

驗證: vector_db_status

替代方案

mcp-logseq 對比其他方案

替代方案何時用它替代權衡
Obsidian MCP (community)你使用 Obsidian 而非 Logseq圖譜語意有所不同
Notion MCP你使用 Notion付費 SaaS 服務;圖譜模型不同
filesystem MCP on the Logseq dir你只需要原始檔案存取無法進行區塊層級操作,也無法執行 DSL 查詢

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills