AI阅读助手

Claude Reader是一款集成AI助手的阅读工具,支持EPUB和PDF格式,提供全文搜索、章节导航和实时高亮功能,使阅读成为与AI的对话体验。

  • by JasonBates
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 JasonBates/claude-reader

使用说明

克劳德读者

大多数读者将人工智能视为事后的想法——一个附加的聊天机器人。克劳德读者是不同的。它给了克劳德 直接访问您正在阅读的内容 通过MCP,你可以突出显示一段话并问“这是什么意思?”,在整个库中搜索一个半熟的想法,或者让克劳德导航到它引用的确切段落。它将阅读转化为对话。

特性

  • EPUB和PDF支持 具有自动章节检测功能-仅适用于您拥有的无DRM书籍
  • Apple Books集成 在macOS上(可选)
  • 全文搜索 所有书籍(FTS5)
  • 简历阅读 从你上一个职位开始
  • 拖放式重新排序 你的阅读清单
  • 实时高亮显示 当克劳德指出段落时,通过苏格兰证券交易所

快速开始

需要 紫外线 Python 3.10+。

git clone https://github.com/JasonBates/claude-reader.git
cd claude-reader
uv run server.py

打开 本地主机:8123.导入一本书并开始阅读。

与克劳德一起阅读

Claude Reader包含一个MCP服务器,可让Claude直接访问您的阅读内容。选择一段文字并按 Cmd+Shift+C 把它发给克劳德,或者问问你在读什么。

“你觉得我刚才强调的这段话怎么样?”

“你能总结一下第三章的主要论点吗?”

“作者首先在哪里介绍了意识的概念?”

设置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "claude-reader": {
      "command": "uv",
      "args": ["run", "mcp_server.py"],
      "cwd": "/path/to/claude-reader"
    }
  }
}

重新启动Claude Desktop,然后用以下命令启动阅读器 uv run server.py.

MCP工具

工具 说明
get_current_chapter 当前在浏览器中打开的章节
get_highlight 通过Cmd+Shift+C发送的文本
get_books 列出图书馆的所有书籍
get_book_info 图书元数据和章节索引
get_chapter 按书脊索引检索任何章节
search_book 书中的全文搜索
search_library 在所有书籍中进行全文搜索
goto 将阅读器导航到特定位置
highlight_in_chapter 导航并突出显示特定句子
highlight_sentences 突出显示当前章节中的句子
clear_highlights 清除读者的所有亮点

导入书籍

你的 macOS上的Apple图书库 当您打开web UI时,会自动扫描。可用的EPUB和PDF出现在库中——单击任何标题即可导入。DRM保护的书籍会自动跳过。

读一本书 古登堡计划 或其他来源,先将其添加到Apple Books,然后从那里导入。

项目结构

claude-reader/
├── server.py              # Entry point (port 8123)
├── mcp_server.py          # MCP server for Claude Desktop
├── app/
│   ├── config.py          # Configuration & shared state
│   ├── database.py        # SQLite + Turso sync layer
│   ├── search.py          # FTS5 full-text search
│   ├── routes/
│   │   ├── views.py       # HTML pages
│   │   ├── api.py         # JSON API
│   │   ├── actions.py     # Form actions (import, delete)
│   │   └── sse.py         # Server-Sent Events
│   └── services/
│       ├── library.py     # Book loading & caching
│       ├── epub.py        # EPUB parsing
│       ├── pdf.py         # PDF parsing
│       └── apple_books.py # macOS integration
├── static/                # CSS and JavaScript
└── templates/             # Jinja2 HTML templates

测试

uv run pytest                    # All tests
uv run pytest -m "not slow"      # Skip slow tests
uv run pytest tests/test_api.py  # Specific file

基于

分叉自 业力/读者3 与Claude集成、PDF支持、全文搜索和模块化架构。

法律声明

Claude Reader设计用于 DRM免费书籍 您有阅读和处理的合法权利。这包括公共领域的作品、开放获取出版物、无DRM购买以及您创建或有权使用的书籍。该软件会自动跳过受DRM保护的文件。

本项目不促进、鼓励或支持规避数字版权管理或版权保护。

免责声明

这是一个独立的个人项目 与Anthropic无关、不受Anthropics认可或赞助“Claude”指的是Anthropic的人工智能助手,读者可以通过公共MCP协议与之集成。

许可证

麻省理工学院