AI导哈

电子书搜索阅读服务

一个用于从Calibre电子书库中搜索和阅读书籍的模型上下文协议（MCP）服务器，支持全文搜索、作者/标题搜索和文本摘录功能。

  • by trieloff
  • Shell
  • 本地部署
  • 59 星标
  • 更新于
在 GitHub 查看 trieloff/calibre-mcp

使用说明

口径mcp

一个模型上下文协议（MCP）服务器，用于从Calibre电子书库中搜索和阅读书籍。

特性

  • 全文搜索 具有自动短语匹配和模糊回退功能
  • 按作者搜索 或 标题 部分匹配
  • 提取文本摘录 来自带有关键字突出显示和分页的书籍
  • 使用纯bash实现 calibredb 命令行界面
  • 返回Calibre深度链接(calibre://)和文件URL(file://)
  • 针对macOS兼容性的强大超时处理

先决条件

  • 卡利伯 安装在 /Applications/calibre.app
  • Calibre图书馆 ~/Calibre Library
  • 用于摘录功能的书籍文本（.txt）导出
  • Bash 4.0或更高版本

安装

  1. 克隆此存储库：
git clone https://github.com/trieloff/calibre-mcp.git
cd calibre-mcp
  1. 使脚本可执行：
chmod +x calibre-mcp.sh

用法

与MCP检查员一起

使用MCP检查器测试服务器：

npx @modelcontextprotocol/inspector /path/to/calibre-mcp.sh

使用克劳德桌面

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "calibre": {
      "command": "/path/to/calibre-mcp.sh"
    }
  }
}

可用工具

搜索全文

使用Calibre的全文搜索引擎搜索书籍。

参数：

  • query （必填）：搜索查询。多词查询会自动进行短语搜索
  • limit （可选）：最大结果（默认值：50）
  • fuzzy_fallback （可选）：如果精确搜索失败，则使用相关术语进行回退查询

例子：

{
  "query": "machine learning",
  "fuzzy_fallback": "AI artificial intelligence ML neural networks deep learning"
}

搜索作者

按部分匹配的作者姓名搜索书籍。

参数：

  • author （必填）：作者姓名（支持部分匹配）
  • limit （可选）：最大结果（默认值：50）

搜索标题

按部分匹配的标题搜索书籍。

参数：

  • title （必填）：书名（支持部分匹配）
  • limit （可选）：最大结果（默认值：50）

获取摘录

从具有关键字上下文的书籍中提取文本摘录。

参数：

  • book_id （必填）：Calibre图书ID
  • keyword （可选）：在书中查找的搜索词
  • context_lines （可选）：匹配项周围的上下文行（默认值：10）
  • max_results （可选）：每页结果（默认值：10）
  • page （可选）：分页页码（默认值：1）

响应格式

搜索结果包括：

  • 书籍元数据（标题、作者、系列、标签、出版商）
  • Calibre深度链接，用于在Calibre中打开
  • 用于直接访问EPUB的文件URL
  • 可用格式
  • 文本格式是否可用于摘录

日志记录

服务器记录所有请求和响应 requests.log 用于调试。

局限性

  • 需要关闭Calibre或可能遇到超时
  • 全文搜索需要索引书籍
  • 摘录提取仅适用于.txt导出

许可证

Apache许可证2.0-请参阅 许可证 文件以获取详细信息。

相关 MCP