Leafhour

用 MCP 讓 AI Agent 連接你的書。

Leafhour 文檔 · 更新於 2026 年 10 月 16 日

Leafhour 的 Model Context Protocol（MCP）轉接器讓相容的 AI 宿主讀取你授權的一本書。它與網頁使用同一個閱讀服務。存取僅限於一本書和你選擇的資料類型；只安裝轉接器不會取得任何權限。

這是技術接入。目前閱讀介面主要為簡體中文，尚無完整的授權管理頁面。建立和撤回授權，請使用現有相容用戶端或已認證的服務 API。需要協助時，請聯絡 support@leafhour.com。

選擇 Agent 可以存取的內容。

權限允許的操作
content原文與已保存的譯文、書籍資訊、分頁章節以及該書內的搜尋。
notes單獨授權的個人評論和問題。
activity已保存的閱讀位置和最近的閱讀時段。
comment:write保存使用者明確提供的評論，並錨定到段落。它不授權修改書籍。

建議先只用 content。授權七天後過期，也可以提前撤回。撤回後，後續服務鑑權會失敗；撤回不能清除已經複製到你的 AI 宿主裡的內容。

連接轉接器。

  1. 按倉庫說明在本地運行 Leafhour，或使用託管閱讀服務。在自己的書房匯入一本書，或選擇一本公版樣書。
  2. 透過相容用戶端或已認證 API，用 POST /api/library/grants 建立帶 bookId 和所選 scopes 的授權。權杖只返回一次，請保存在 AI 宿主的私密設定裡。
  3. 讀取 GET /api/library/mcp-setup，並用設定產生器建立宿主設定。本地原始碼運行時，轉接器以 node server/mcp.mjs 啟動。託管接入會返回實際部署的原始碼提交，產生的設定固定到這份不可變的原始碼包並明確允許 HTTPS 書房；缺少部署來源時直接拒絕。
  4. 在相容的 AI 宿主中啟用 MCP 伺服器，並在工具請求中帶上授權的書籍 ID。用完後可用 POST /api/library/grants/{id}/revoke 撤回授權。

轉接器使用這些環境變數：

READER_SERVICE_URL=http://127.0.0.1:8330
READER_AGENT_TOKEN=<your book-scoped grant>

# For your configured HTTPS service only:
# READER_SERVICE_URL=https://leafhour.com
# READER_ALLOW_REMOTE=true

不要把登入密碼、工作階段 Cookie、Supabase 金鑰或授權權杖寫進公開文檔或倉庫。MCP 授權與網頁登入相互獨立。宿主提供金鑰儲存時，請使用它。

先取一段，再往深處讀。

reader_get_manifest 返回這本書的來源資訊和章節標識。reader_get_context 返回一個段落及其鄰段和穩定錨點。reader_get_chapter 每次最多返回 20 段和繼續游標。reader_search 在授權書籍內搜尋，最多返回 20 條帶錨點的結果。

配合其他權限，reader_get_notes 讀取評論和問題，reader_get_reading_activity 讀取位置和閱讀時段，reader_add_comment 保存使用者明確提供的文字。Agent 的存取不會計入閱讀日曆。

例如：「在我授權的書裡找出關於友誼的段落，顯示來源章節和段落錨點，幫我比較作者的措辭。」Agent 需要書籍 ID；它無法推斷出搜尋整個私人書房的權限。

了解目前的限制。

轉接器也提供音訊工具，但託管音訊生成未開放。本地音訊需要單獨設定和權限；生成音訊可能產生供應商費用。MCP 目前不能上傳書籍、自動翻譯整個書庫，也不會自行安排通知。

站內閱讀助手有獨立的唯讀邊界，與這個外部 MCP 授權相互獨立。託管處理細節見隱私與資料說明。

確切的工具定義和目前服務行為，請查看轉接器原始碼、服務路由和按書授權的 MCP 閱讀說明。本文描述目前實作，不是計畫中的能力。