calibre-mcp

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

功能

• 全文搜索，自动短语匹配和模糊回退
• 按作者或标题搜索，支持部分匹配
• 提取文本摘录，关键词高亮和分页
• 使用calibredb命令行工具的纯Bash实现
• 返回Calibre深层链接（calibre://）和文件URL（file://）
• 坚固的超时处理以兼容macOS

预备条件

• 在/Applications/calibre.app安装Calibre
• 在~/Calibre Library有一个Calibre图书馆
• 您书籍的文本(.txt)导出，用于摘录功能
• Bash 4.0或更高版本

安装

1. 克隆此仓库：

git clone https://github.com/trieloff/calibre-mcp.git
cd calibre-mcp

2. 将脚本设置为可执行：

chmod +x calibre-mcp.sh

使用方法

使用MCP Inspector

使用MCP Inspector测试服务器：

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

使用Claude Desktop

添加到您的Claude Desktop配置：

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

可用工具

search-fulltext

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

参数：

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

示例：

{
  "query": "机器学习",
  "fuzzy_fallback": "AI 人工智能 ML 神经网络 深度学习"
}

search-author

通过作者姓名部分匹配搜索书籍。

参数：

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

search-title

通过标题部分匹配搜索书籍。

参数：

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

get-excerpt

从书籍中提取文本摘录，带有关键词上下文。

参数：

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

响应格式

搜索结果包括：

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

日志

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

限制

• 需要关闭Calibre，否则可能会出现超时
• 全文搜索需要索引书籍
• 摘录提取仅适用于.txt导出

许可证

Apache许可证2.0 - 查看LICENSE文件获取详情。 </中文翻译>