作者 onebirdrocks · onebirdrocks/ebook-mcp
將 Claude 指向你的 EPUB 和 PDF 書庫——以結構化形式取得元資料、目錄與章節內容，讓模型能精確引用與摘要。
ebook-mcp 將 Python 常見的 EPUB/PDF 函式庫封裝為 MCP 工具。不同於一般的「讀取檔案」，它暴露了目錄結構與章節邊界，讓 Claude 只需擷取你所詢問的特定章節，而非將 500 頁全部塞入上下文。
uv pip install -e . 安裝%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"ebook": {
"command": "uvx",
"args": [
"ebook-mcp"
],
"_inferred": true
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"ebook": {
"command": "uvx",
"args": [
"ebook-mcp"
],
"_inferred": true
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"ebook": {
"command": "uvx",
"args": [
"ebook-mcp"
],
"_inferred": true
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"ebook": {
"command": "uvx",
"args": [
"ebook-mcp"
],
"_inferred": true
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "ebook",
"command": "uvx",
"args": [
"ebook-mcp"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"ebook": {
"command": {
"path": "uvx",
"args": [
"ebook-mcp"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add ebook -- uvx ebook-mcp一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 「那本書裡有段關於 X 的內容……」——你需要確切的引文，卻懶得翻頁查找。
結果： 2 分鐘內取得可引用的原文段落。
何時使用： 你想判斷是否值得閱讀某本書，或讀完後需要複習重點。
結果： 可分享或日後複習的 1-2 頁書籍精華。
何時使用： 你的書庫有 500 本電子書，想找出缺少書名或作者元資料的檔案。
結果： 快速完成元資料整理。
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| get_metadata | path: str | 對任何書籍進行第一步操作 | free |
| get_toc | path: str | 在擷取章節內容之前呼叫 | free |
| get_chapter | path, chapter_id or id_range | 載入特定章節 | free |
| get_pages | path, from_page, to_page (PDF only) | 用於 PDF 的頁面範圍擷取 | free |
Unable to parse PDF掃描版或純圖片 PDF 沒有文字層，請先執行 ocrmypdf。
pdftotext input.pdf - | headEPUB chapter ID not found章節 ID 須與目錄完全一致，請先呼叫 get_toc。
Large PDF makes get_chapter timeout改用 get_pages 並縮小頁面範圍，分批處理。
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| Calibre + custom script | 你需要完整的 Calibre 整合 | 設定較複雜；沒有 MCP 封裝 |
| pdfplumber / pymupdf directly | 你要自行開發工具 | 需要自行實作 MCP 封裝 |