Komga Ebook Search

Komga电子书图书馆

使用模型上下文协议通过人工智能搜索和阅读您的Komga电子书集

](https://www.npmjs.com/package/@sylweriusz/komga-ebook-search) 

连接您的 群组 数字图书馆到克劳德等人工智能助手，实现智能图书发现、内容阅读和电子书收藏的全文搜索。

🎯 目的

Bridge AI助手与数字图书馆基础设施相结合，为研究、事实核查和学术引文提供权威的来源访问。 核心理念：Komga寻找书籍，我们搜索IN书籍。

✨ 主要特点

• 智能格式检测：自动EPUB与PDF处理
• 全文检索：FlexSearch集成，实现即时内容发现
• 克劳德视觉OCR：非文本内容的智能PDF处理
• 会话缓存：优化了重复访问的性能
• 保守派的倒退：优雅的降级可防止用户体验不佳

📚 格式支持矩阵

🚀 快速开始

安装

# Via NPM (recommended)
npx @sylweriusz/komga-book-search

# Via Smithery (for Claude Desktop)
npx @smithery/cli install @sylweriusz/komga-book-search --client claude

配置

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "komga-ebook-search": {
      "command": "npx",
      "args": ["@sylweriusz/komga-book-search"],
      "env": {
        "KOMGA_URL": "http://your-komga-server:25600",
        "KOMGA_USERNAME": "your-username",
        "KOMGA_PASSWORD": "your-password",
        "KOMGA_LIBRARY": "your-library-filter"
      }
    }
  }
}

🛠️ MCP工具

search_library_books(query, library_filter?)

通过格式检测发现图书馆馆藏中的书籍。

// Find academic books on specific topics
{
  "query": "artificial intelligence",
  "library_filter": "academic"  // optional
}

get_book_overview(book_id)

检索完整的图书元数据，包括页数和格式信息。

{
  "book_id": "0K79C4PQAEH7J"
}

read_book_pages(book_id, start_page, end_page)

通过智能格式路由访问书籍内容（最多15页）。

• EPUB：返回带有章节分隔符的纯文本
• PDF文件：返回针对Claude Vision OCR优化的压缩图像

search_within_book(book_id, search_term)

在个人书籍中进行全文搜索。

• EPUB和文本PDF：带上下文和亮点的FlexSearch
• 图像PDF：使用指南 read_book_pages Claude Vision

💡 用例

• 学术研究：在学术书籍中搜索引文和参考文献
• 事实核查：对权威来源的交叉引用索赔
• 语言学习：在上下文中查找对话示例和词汇
• 技术文档：高效地浏览复杂的技术手册

🏗️ 建筑

内置于 精益架构方法论（LAM）:

• 垂直特征切片：每个MCP工具都是独立的功能
• 依赖注入：以建筑商为基础，无单体
• 严格的类型安全：零 any 类型，全面的TypeScript
• 单一责任：一个文件，一个目的
• 无循环依赖关系：明确依赖方向

📋 需求

• Node.js：18.0.0或更高
• Komga服务器：正在运行具有API访问权限的实例
• TypeScript：包含在依赖项中

🔧 发展

# Clone and setup
git clone https://github.com/sylweriusz/komga-ebook-search.git
cd komga-ebook-search
npm install

# Build and run
npm run build
npm start

# Development mode
npm run dev

📝 配置变量

🐛 故障排除

连接问题

• 验证Komga服务器是否可访问
• 检查身份验证凭据
• 确保用户具有PAGE_STREAMING角色

搜索问题

• 确认 KOMGA_LIBRARY 筛选器与现有库匹配
• 检查书籍格式支持（文本搜索首选EPUB）

性能问题

• 首次访问时的EPUB索引（2-4秒）
• 后续搜索使用缓存索引（\<1秒）
• 大型PDF可能需要耐心进行初始处理

📄 许可证

MIT© 西尔维尔

🤝 贡献

欢迎投稿！请阅读我们的 贡献指南 并遵循LAM架构原则。

🔗 相关项目

• 群组 -漫画/电子书服务器和网络阅读器
• 模型上下文协议 -AI工具集成的开放标准
• 史密瑟里 -MCP服务器注册和市场

______________________________________________________________________

专为需要人工智能访问其藏书的研究人员、学者和数字图书馆爱好者而设计。