Calibre MCP 服务器

一个提供本地 Calibre 库访问的 MCP(模型上下文协议)服务器,支持通过标题、作者、标签或其他元数据搜索书籍,检索详细书籍信息,访问 EPUB 书籍章节和内容,以及在 EPUB 书籍文本内容中搜索。

  • by benoute
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 benoute/calibre-mcp

使用说明

Calibre MCP服务器

提供对本地Calibre库访问的MCP(模型上下文协议)服务器。

特性

  • 按标题、作者、标签或其他元数据搜索书籍
  • 检索详细的图书信息
  • 访问EPUB书籍章节和内容
  • 在EPUB图书文本内容中搜索
  • 支持stdio和HTTP流式传输

用法

构建

go build ./cmd/calibre-mcp

跑

标准模式(适用于本地MCP客户端)

./calibre-mcp -transport=stdio -library-path=/path/to/calibre/library

HTTP模式(用于远程访问)

./calibre-mcp -transport=http -port=8080 -library-path=/path/to/calibre/library

工具

搜索_书籍

按标题、作者、标签或其他元数据在Calibre库中搜索书籍。返回包含基本信息的匹配书籍列表。支持限制和偏移,以便在结果中快速分页。

参数:

  • query:搜索查询字符串
  • limit:最大结果数(可选)
  • offset:分页偏移量(可选)

get_book

从Calibre库中按ID检索特定书籍的详细信息。

参数:

  • id:图书ID

get_epub_chapters

通过ID从Calibre库获取EPUB书籍中的章节列表。

参数:

  • book_id:图书ID

get_epub_chapter_content

从Calibre库获取EPUB书中特定章节的文本内容。

参数:

  • book_id:图书ID
  • chapter_index:章节索引(从0开始)

搜索_公开_内容

从Calibre库中搜索EPUB书籍内容中的文本,并返回与章节信息匹配的段落。支持限制和偏移以实现快速分页-使用偏移遍历结果。

参数:

  • book_id:图书ID
  • query:搜索查询字符串
  • limit:最大结果数(可选)
  • offset:分页偏移量(可选)

需求

  • 转到1.25+
  • 访问包含元数据.db的本地Calibre库目录