作者 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 |
无法解析 PDF扫描/仅图像 PDF 没有文本层。先运行 ocrmypdf。
pdftotext input.pdf - | head未找到 EPUB 章节 IDID 来自目录。先调用 get_toc。
大型 PDF 导致 get_chapter 超时使用 get_pages，缩小页码范围；批处理。
| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| Calibre + 自定义脚本 | 你想要完整的 Calibre 集成 | 需要更多设置；没有 MCP 包装器 |
| 直接使用 pdfplumber / pymupdf | 你构建自己的工具 | 构建你自己的 MCP 包装器 |