精读增强型MCP服务器

Name: 精读增强型MCP服务器
Author: arnaldo-delisio

作者：arnaldo-delisio35 星标更新：2025-08-16

安装使用来源：spider==github.com

项目介绍

技术文档摘要

Readwise MCP Enhanced

一个全面的模型上下文协议（MCP）服务器，统一了Readwise Reader文档管理和完整的Readwise高亮功能。适用于Claude Desktop、Continue以及任何兼容MCP的人工智能工具。使用TypeScript构建，具有高级文本处理、智能内容控制和上下文优化响应。

🚀 这是什么

首个统一的MCP，结合了以下功能：

完整的Readwise Reader API - 保存、管理和搜索文档
完整的Readwise高亮API - 访问所有高亮、书籍和每日复习
基于AI的文本处理 - 智能分词和内容提取
上下文优化 - 在保持全部功能的同时减少94%的令牌使用
智能内容控制 - 使用高级过滤和分页防止上下文爆炸

相当于官方的Readwise MCP，但更高效且功能齐全。兼容所有MCP客户端。

✨ 关键特性

📚 增强的阅读器管理

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

🎯 完整的高亮生态系统

每日复习：间隔重复学习系统
高级搜索：特定字段查询并带有相关性评分
书籍管理：完整元数据，包括高亮计数和过滤
导出与备份：批量高亮分析和增量同步
手动创建：添加高亮并支持完整元数据

⚡ 生产卓越

上下文优化：减少94%的令牌使用（25,600 → 1,600个令牌）
双API架构：无缝集成v2（高亮）+ v3（阅读器）
无限结果：没有人为限制，仅高效的数据项
符合MCP协议：适当的日志记录、错误处理和速率限制

🛠️ 安装

选项1：NPX - 不需要安装！（推荐）

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

选项2：全局NPM安装

npm install -g readwise-mcp-enhanced

选项3：从源代码安装

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

🔧 配置

与任何兼容MCP的工具一起使用

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

添加到你的MCP客户端配置中：

Claude Desktop：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

Continue IDE扩展：

添加到你的Continue配置文件中

其他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"
      }
    }
  }
}

重启你的MCP客户端（Claude Desktop、Continue等）

📖 可用工具（总计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：每个文档的内容限制（默认：50,000字符）
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": "战略智慧引用...",
      "title": "孙子兵法",
      "author": "孙武"
    }
  ]
}

`readwise_search_highlights`

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

{
  "textQuery": "策略战术",
  "fieldQueries": [
    {
      "field": "document_title",
      "searchTerm": "孙子兵法"
    }
  ],
  "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": "重要见解...",
      "title": "书名",
      "author": "作者名",
      "note": "我对这个的看法",
      "category": "books"
    }
  ]
}

🎯 上下文优化

在保持全部功能的同时减少94%的令牌使用：

工具	之前	现在	节省
列出高亮（32项）	~25,600个令牌	~1,600个令牌	94%
每日复习（5项）	~5,000个令牌	~400个令牌	92%
列出书籍（10项）	~8,000个令牌	~600个令牌	93%

优化字段：

高亮：仅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客户端系统

// 无缝API切换
v2 API: 高亮、书籍、每日复习、导出
v3 API: 阅读器文档、标签、搜索

上下文高效的结构设计

无限结果，每项数据最小化
针对LLM优化的响应便于高效解析
结构化的JSON保持完整的推理能力

生产就绪

ES模块标准，带有适当的TypeScript定义
符合MCP协议的日志记录和错误处理
全面的速率限制和优雅的回退机制

⚙️ API覆盖范围

Readwise阅读器API（v3）

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

Readwise高亮API（v2）

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

🔐 认证与安全

单一令牌：两个API共用一个Readwise令牌
环境变量：通过READWISE_TOKEN安全存储令牌
无令牌暴露：从未通过MCP客户端或工具界面暴露

📈 速率限制

阅读器API：每分钟20次请求（默认），创建/更新时每分钟50次
高亮API：标准的Readwise限制，并自动处理重试
智能处理：429响应包括“重试后”头处理

🚀 使用示例

智能内容提取

// 对大型文档进行分页
readwise_list_documents({
  withFullContent: true,
  contentMaxLength: 5000,
  contentStartOffset: 0,
  contentFilterKeywords: ["机器学习", "AI"]
})

综合搜索

// 在文档和高亮之间进行搜索
readwise_search_highlights({
  textQuery: "生产力习惯",
  fieldQueries: [
    { field: "document_author", searchTerm: "詹姆斯·克利尔" }
  ],
  limit: 10
})

每日学习工作流

// 获取每日复习进行间隔重复
readwise_get_daily_review()

// 搜索相关高亮进行深入研究
readwise_search_highlights({
  textQuery: "来自每日复习主题",
  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%）
✅ 统一接口（阅读器+高亮）
✅ 智能内容控制（分页、过滤）
✅ 基于AI的文本处理
✅ 无限结果，最小冗余

对比基础阅读器MCP

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

📄 许可证

MIT

🙏 致谢

基于edricgan/Readwise-Reader-MCP的基础进行了显著增强：

增强的阅读器功能，带有智能内容控制
完整的高亮整合，相当于官方MCP
基于AI的文本处理，带有分词
上下文优化，用于生产效率
统一架构，无缝结合双API

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