AI导哈

电子书搜索阅读服务

一个轻量级的Node.js MCP服务器，用于从Calibre电子书库中搜索和阅读书籍，特别针对Windows环境优化。

  • by ispyridis
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 ispyridis/calibre-mcp-nodejs

使用说明

Calibre MCP服务器

一个轻量级的Node.js MCP服务器，用于从Calibre电子书库中搜索和阅读书籍。专为Windows兼容性而设计。

特性

  • 库搜索：按标题、作者或内容搜索Calibre库
  • 图书阅读：检索和阅读各种格式的书籍内容
  • 元数据访问：获取详细的图书信息和元数据
  • Windows兼容的：针对Windows环境进行了优化
  • 零依赖：无外部依赖的轻量级实现

先决条件

  • Node.js>=16.0.0
  • Calibre安装在Windows上

安装

  1. 克隆此存储库：
git clone https://github.com/yourusername/calibre-mcp-nodejs.git
cd calibre-mcp-nodejs
  1. 安装依赖项：
npm install

用法

启动服务器

npm start

可用工具

  • search：在Calibre图书馆中搜索书籍
  • fetch：使用epub://URL从书籍中检索特定内容

MCP配置示例

添加到MCP客户端配置中：

{
  "mcpServers": {
    "calibre": {
      "command": "node",
      "args": ["path/to/calibre-mcp-nodejs/server.js"]
    }
  }
}

配置

服务器会自动检测您的Calibre库位置。搜索在常见安装路径中查找Calibre：

  • C:\Program Files\Calibre2\
  • C:\Program Files (x86)\Calibre2\
  • 通过环境变量自定义路径

api参考

搜索书籍

// Search by title
search({ query: "title:\"The Great Gatsby\"" })

// Search by author  
search({ query: "author:\"F. Scott Fitzgerald\"" })

// Full-text search
search({ query: "green light" })

获取书籍内容

// Fetch specific book content
fetch({ url: "epub://book_id/chapter_1" })

项目结构

calibre-mcp-nodejs/
├── server.js          # Main MCP server
├── package.json       # Dependencies and scripts
├── test.js            # Test file
├── test.bat           # Windows test script
└── README.md          # This file

测试

运行测试：

npm test

或者使用Windows批处理文件：

test.bat

故障排除

常见问题

  1. 未找到机芯：确保Calibre安装在标准位置
  2. 图书馆访问：确保Calibre库可访问且未锁定
  3. 权限：以适当的权限运行以访问Calibre文件

调试模式

设置详细日志记录的DEBUG环境变量：

set DEBUG=calibre:*
npm start

支持格式

服务器支持Calibre可以处理的所有格式：

  • 电子版
  • 可移植文档格式
  • 莫比
  • AZW/AZW3
  • 文本
  • 超文本标记语言
  • 更多

演出

此轻量级服务器设计用于：

  • 快速启动时间
  • 内存使用率低
  • 快速搜索响应
  • 对系统的影响最小

与RAG版本的比较

这是轻量级版本。有关矢量搜索、语义相似性和RAG功能等高级功能，请参阅 calibre rag mcp nodejs.

功能 简单版本 RAG版本
基本搜索 ✅ ✅
读书 ✅ ✅
依赖关系 无 多
内存使用率 低 高
矢量搜索 ❌ ✅
语义搜索 ❌ ✅
OCR支持 ❌ ✅
项目组织 ❌ ✅

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 添加新功能的测试
  5. 提交拉取请求

许可证

根据Apache许可证2.0授权。有关详细信息，请参阅LICENSE文件。

支持

有关问题和疑问，请在GitHub上打开问题。

更新日志

v2.0.0版本

  • 改进了Windows兼容性
  • 增强的搜索功能
  • 更好的错误处理
  • 优化性能

v1.0.0

  • 初始版本
  • 基本搜索和获取功能
  • Windows支持

相关 MCP