Calibre MCP服务器
一个轻量级的Node.js MCP服务器，用于从Calibre电子书库中搜索和阅读书籍。专为Windows兼容性而设计。
特性
- 库搜索：按标题、作者或内容搜索Calibre库
- 图书阅读：检索和阅读各种格式的书籍内容
- 元数据访问：获取详细的图书信息和元数据
- Windows兼容的：针对Windows环境进行了优化
- 零依赖：无外部依赖的轻量级实现
先决条件
- Node.js>=16.0.0
- Calibre安装在Windows上
安装
- 克隆此存储库：
git clone https://github.com/yourusername/calibre-mcp-nodejs.git
cd calibre-mcp-nodejs- 安装依赖项：
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故障排除
常见问题
- 未找到机芯：确保Calibre安装在标准位置
- 图书馆访问：确保Calibre库可访问且未锁定
- 权限：以适当的权限运行以访问Calibre文件
调试模式
设置详细日志记录的DEBUG环境变量：
set DEBUG=calibre:*
npm start支持格式
服务器支持Calibre可以处理的所有格式：
- 电子版
- 可移植文档格式
- 莫比
- AZW/AZW3
- 文本
- 超文本标记语言
- 更多
演出
此轻量级服务器设计用于：
- 快速启动时间
- 内存使用率低
- 快速搜索响应
- 对系统的影响最小
与RAG版本的比较
这是轻量级版本。有关矢量搜索、语义相似性和RAG功能等高级功能，请参阅 .
| 功能 | 简单版本 | RAG版本 |
|---|---|---|
| 基本搜索 | ✅ | ✅ |
| 读书 | ✅ | ✅ |
| 依赖关系 | 无 | 多 |
| 内存使用率 | 低 | 高 |
| 矢量搜索 | ❌ | ✅ |
| 语义搜索 | ❌ | ✅ |
| OCR支持 | ❌ | ✅ |
| 项目组织 | ❌ | ✅ |
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 添加新功能的测试
- 提交拉取请求
许可证
根据Apache许可证2.0授权。有关详细信息，请参阅LICENSE文件。
支持
有关问题和疑问，请在GitHub上打开问题。
更新日志
v2.0.0版本
- 改进了Windows兼容性
- 增强的搜索功能
- 更好的错误处理
- 优化性能
v1.0.0
- 初始版本
- 基本搜索和获取功能
- Windows支持