Readwise MCP Enhanced

______________________________________________________________________

状态：已发布 类别：mcp服务器 作者：阿纳尔多·德利西奥 published_npm:true npm_package：readwise mcp增强 已发布目录：\[\] 生产url：空 最新活动：2026-01-26

重新读取MCP增强

](https://badge.fury.io/js/readwise-mcp-enhanced) ](https://www.npmjs.com/package/readwise-mcp-enhanced)

一个统一的综合模型上下文协议（MCP）服务器 Readwise阅读器 文档管理 Readwise的全部亮点 功能。适用于Claude Desktop、Continue和任何兼容MCP的AI工具。使用TypeScript构建，具有高级文本处理、智能内容控件和上下文优化的响应。

🚀 这是什么

第一个统一的MCP 它结合了：

• 完整阅读阅读器API -保存、管理和搜索文档
• API全文阅读要点 -访问您的所有精彩内容、书籍和每日评论
• 人工智能驱动的文本处理 -智能分词与内容提取
• 上下文优化 -令牌使用量减少94%，同时保持完整功能
• 智能内容控制 -通过高级过滤和分页防止上下文爆炸

相当于官方Readwise MCP 但更高效且功能更完整。与所有MCP客户端兼容。

______________________________________________________________________

✨ 主要特点

📚 增强的读者管理

• 智能内容提取：分页、关键字过滤、长度限制
• 人工智能驱动的文本处理：自动分词修复合并单词
• 性能控制：为昂贵的操作提供内置警告和指导
• 灵活过滤：按位置、类别、标签、日期和自定义条件

🎯 完整亮点生态系统

• 每日评论：空间重复学习系统
• 高级搜索：具有相关性评分的现场特定查询
• 图书管理：带有突出显示计数和过滤的完整元数据
• 导出和备份：批量高亮分析和增量同步
• 手动创建：添加具有完整元数据支持的亮点

⚡ 卓越生产

• 上下文优化：代币使用量减少94%（25600→1600个代币）
• 双API体系结构：无缝v2（亮点）+v3（阅读器）集成
• 无限结果：没有人为的限制，每个项目都有高效的数据
• 符合MCP协议：正确的日志记录、错误处理和速率限制

______________________________________________________________________

🛠️ 安装

选项1:NPX-无需安装！（推荐）

无需安装！任何MCP客户端都将使用npx自动下载并运行该包。

选项2：全球NPM安装

npm install -g readwise-mcp-enhanced

选项3：来源

git clone https://github.com/arnaldo-delisio/readwise-mcp-enhanced.git
cd readwise-mcp-enhanced
npm install
npm run build

🔧 配置

使用任何MCP兼容工具

1. 获取您的Readwise令牌： https://readwise.io/access_token

1. 添加到MCP客户端配置中：

克劳德桌面：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

继续IDE扩展：

- 添加到“继续”配置文件

其他MCP工具：

- 按照工具的MCP服务器配置说明进行操作

#### 选项A-使用npx（推荐）：

   {
     "mcpServers": {
       "readwise-mcp-enhanced": {
         "command": "npx",
         "args": ["readwise-mcp-enhanced"],
         "env": {
           "READWISE_TOKEN": "your_readwise_access_token_here"
         }
       }
     }
   }

#### 选项B-如果通过npm全局安装：

   {
     "mcpServers": {
       "readwise-mcp-enhanced": {
         "command": "readwise-mcp-enhanced",
         "env": {
           "READWISE_TOKEN": "your_readwise_access_token_here"
         }
       }
     }
   }

#### 选项C-如果从源安装：

   {
     "mcpServers": {
       "readwise-mcp-enhanced": {
         "command": "node",
         "args": ["/path/to/readwise-mcp-enhanced/dist/index.js"],
         "env": {
           "READWISE_TOKEN": "your_readwise_access_token_here"
         }
       }
     }
   }

1. 重新启动MCP客户端 （克劳德桌面、继续等）

______________________________________________________________________

📖 可用工具（共13个）

📚 阅读器工具（6）-增强版

readwise_save_document

保存具有完全元数据控制的文档。

{
  "url": "https://example.com/article",
  "tags": ["ai", "productivity"],
  "location": "later",
  "category": "article"
}

readwise_list_documents

⭐ 通过智能内容控制增强

{
  "withFullContent": true,
  "contentMaxLength": 10000,
  "contentStartOffset": 0,
  "contentFilterKeywords": ["AI", "machine learning"],
  "limit": 10
}

智能内容参数：

• contentMaxLength：限制每个文档的内容（默认值：50000个字符）
• contentStartOffset：从特定位置开始提取（分页）
• contentFilterKeywords：仅提取包含关键字的部分
• 性能警告 用于昂贵的操作

readwise_update_document

更新文档元数据（标题、作者、摘要、位置等）

readwise_delete_document

从阅读器库中删除文档

readwise_list_tags

获取所有文档标签

readwise_topic_search

⭐ 通过AI驱动的文本处理进行增强

• 基于正则表达式的标题、摘要、注释、标签搜索
• 自动分词以实现更好的匹配
• 在整个内容中分布式关键字查找

______________________________________________________________________

🎯 亮点工具（7）-新增

readwise_list_highlights

使用高级筛选列出突出显示：

{
  "book_id": 12345,
  "highlighted_at__gt": "2024-01-01T00:00:00Z",
  "page_size": 100
}

readwise_get_daily_review

获得你的间隔重复亮点：

{
  "review_id": 168844911,
  "highlights": [
    {
      "text": "Strategic wisdom quote...",
      "title": "The Art of War",
      "author": "Sun Tzu"
    }
  ]
}

readwise_search_highlights

⭐ 具有特定字段查询的高级搜索：

{
  "textQuery": "strategy tactics",
  "fieldQueries": [
    {
      "field": "document_title",
      "searchTerm": "Art of War"
    }
  ],
  "limit": 20
}

readwise_list_books

获取带有突出显示元数据的书籍：

{
  "category": "books", 
  "last_highlight_at__gt": "2024-01-01T00:00:00Z"
}

readwise_get_book_highlights

从特定书籍中获取所有精彩内容：

{
  "bookId": 53827741
}

readwise_export_highlights

用于分析和备份的批量导出：

{
  "updatedAfter": "2024-01-01T00:00:00Z",
  "includeDeleted": false
}

readwise_create_highlight

手动添加带有元数据的亮点：

{
  "highlights": [
    {
      "text": "Important insight...",
      "title": "Book Title",
      "author": "Author Name",
      "note": "My thoughts on this",
      "category": "books"
    }
  ]
}

______________________________________________________________________

🎯 上下文优化

代币减少94% 同时保持完整功能：

优化字段：

• 亮点: id, text, note, book_id 仅
• 书籍: id, title, author, category, num_highlights 仅
• 搜索: text, book, author, score 仅

______________________________________________________________________

🧠 AI驱动的功能

智能分词

自动修复常见的文本提取问题：

• whatyou → what you
• fromdissatisfaction → from dissatisfaction
• timeago → time ago

智能内容处理

• 基于句子的组块 YouTube成绩单
• 分布式关键字过滤 贯穿整个内容
• 上下文感知文本提取 间距适当

高级搜索算法

• 多字段搜索 具有相关性评分
• 基于出口的综合搜索 相当于官方MCP
• 特定字段过滤 （标题、作者、文本、注释、标签）

______________________________________________________________________

📊 技术架构

双API客户端系统

// Seamless API switching
v2 API: Highlights, books, daily review, export
v3 API: Reader documents, tags, search

上下文高效设计

• 无限结果 每项数据最少
• LLM优化响应 用于高效解析
• 结构化JSON 保持完整的推理能力

生产就绪

• ES模块标准 使用正确的TypeScript定义
• 符合MCP协议 日志记录和错误处理
• 综合限速 优雅的后撤

______________________________________________________________________

⚙️ API覆盖范围

读卡器API（v3）

• ✅ 文档：保存、列出、更新、删除
• ✅ 标签：列表和过滤器
• ✅ 内容：带控件的智能提取
• ✅ 搜索：增强的主题搜索

Readwise亮点API（v2）

• ✅ 亮点：列表、创建、搜索、导出
• ✅ 书籍：包含元数据和过滤的列表
• ✅ 每日回顾：间隔重复系统
• ✅ 高级搜索：特定字段查询

______________________________________________________________________

🔐 身份验证和安全

• 单一代币：两个API都有一个Readwise令牌
• 环境变量：通过安全令牌存储 READWISE_TOKEN
• 无代币敞口：从不通过MCP客户端或工具界面暴露

______________________________________________________________________

📈 速率限制

• 读者API：20个请求/分钟（默认），50个/分钟（创建/更新）
• API亮点：标准Readwise限制，处理后自动重试
• 智能操控：429个响应包括“Retry After”标头处理

______________________________________________________________________

🚀 使用示例

智能内容提取

// Paginate through large document
readwise_list_documents({
  withFullContent: true,
  contentMaxLength: 5000,
  contentStartOffset: 0,
  contentFilterKeywords: ["machine learning", "AI"]
})

综合搜索

// Search across documents and highlights
readwise_search_highlights({
  textQuery: "productivity habits",
  fieldQueries: [
    { field: "document_author", searchTerm: "James Clear" }
  ],
  limit: 10
})

日常学习工作流程

// Get daily review for spaced repetition
readwise_get_daily_review()

// Search related highlights for deeper study
readwise_search_highlights({
  textQuery: "from daily review topics",
  limit: 20
})

______________________________________________________________________

📦 依赖项

{
  "@modelcontextprotocol/sdk": "^1.0.0",
  "dotenv": "^16.3.0", 
  "node-html-parser": "^7.0.1",
  "wordsninja": "^1.0.0"
}

密钥添加: wordsninja 用于AI驱动的分词

______________________________________________________________________

🔄 从基本读取器MCP迁移

这个统一的MCP是 完全向后兼容。所有现有的阅读器工具在添加7个新的突出显示工具时都保持不变。

没有突破性的变化 -只是增强了功能和更好的性能。

______________________________________________________________________

🌟 为什么选择MCP？

与官方Readwise MCP

• ✅ 更具上下文效率 （减少94%）
• ✅ 统一接口 （读者+亮点）
• ✅ 智能内容控制 （分页、过滤）
• ✅ 人工智能驱动的文本处理
• ✅ 无限结果 尽量不冗长

与基本读卡器MCP相比

• ✅ 完整的亮点生态系统 （7个新工具）
• ✅ 高级搜索功能
• ✅ 生产就绪性能
• ✅ 上下文优化

______________________________________________________________________

📄 许可证

麻省理工学院

______________________________________________________________________

🙏 致谢

建立在以下基础之上 edricgan/Readwise阅读器MCP 具有显著增强功能：

• 增强的阅读器功能 具有智能内容控制
• 完成亮点整合 相当于官方MCP
• 人工智能驱动的文本处理 带分词功能
• 上下文优化 为了提高生产效率
• 统一架构 无缝结合双API

这代表了从基本文档管理到全面的、可用于生产的Readwise平台的完整演变。 🚀