Readwise Reader MCP

🚀 Readwise Reader MCP 服务器

Readwise Reader MCP 服务器是一个基于 TypeScript 和官方 Claude SDK 构建的模型上下文协议（MCP）服务器，用于与 Readwise Reader API 进行交互。它为用户提供了一套安全、高效且功能丰富的文档管理解决方案。

✨ 主要特性

• 安全认证：使用环境变量存储令牌，确保认证信息的安全。
• 文档管理：支持对文档进行保存、列出、更新和删除操作，并能完整管理文档元数据。
• 标签管理：可列出标签并根据标签进行文档过滤。
• 丰富的过滤功能：能根据文档的位置、类别、标签等多种条件进行过滤。
• 分页支持：有效处理大量文档集合。
• 对大语言模型友好的内容：使用 r.jina.ai 自动将 HTML 内容转换为简洁文本。
• 完整的数据访问：返回包括内容、元数据和时间戳在内的完整文档信息。

📦 安装指南

npm install
npm run build

📚 详细文档

配置

与 Claude Desktop 集成

1. 构建 MCP 服务器：

   npm install
   npm run build
   

2. 获取 Readwise 访问令牌：从 https://readwise.io/access_token 获取你的 Readwise 访问令牌。

3. 将服务器添加到 Claude Desktop 配置中：打开 Claude Desktop 设置，在 MCP 服务器配置中添加以下内容：

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

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

   请将 /path/to/your/reader_readwise_mcp 替换为该项目目录的实际路径，将 your_readwise_access_token_here 替换为你实际的 Readwise 访问令牌。

4. 重启 Claude Desktop

可用工具

readwise_save_document

将文档（URL 或 HTML 内容）保存到 Readwise Reader。 参数：

• url（必需）：要保存的文档的 URL。
• html（可选）：文档的 HTML 内容。
• tags（可选）：要添加的标签数组。
• location（可选）：保存位置（new, later, shortlist, archive, feed）。
• category（可选）：文档类别（article, book, tweet, pdf, email, youtube, podcast）。

readwise_list_documents

列出 Readwise Reader 中的文档，并支持可选的过滤功能。返回包括元数据和对大语言模型友好的文本内容在内的完整文档信息。 参数：

• id（可选）：按特定文档 ID 过滤。
• updatedAfter（可选）：过滤在指定日期（ISO 8601 格式）之后更新的文档。
• location（可选）：按文档位置过滤。
• category（可选）：按文档类别过滤。
• tag（可选）：按标签名称过滤。
• pageCursor（可选）：分页的页面游标。
• withHtmlContent（可选）：⚠️ 性能警告：在响应中包含 HTML 内容，这会显著降低 API 速度。仅在用户明确要求或任务特别需要原始 HTML 时使用。
• withFullContent（可选）：⚠️ 性能警告：在响应中包含完整的转换后文本内容，这会因获取和处理每个文档的内容而显著降低 API 速度。仅在用户明确要求或文档内容特别需要用于分析/阅读时使用。默认值为 false 以提高性能。 返回值： 包含所有可用字段的完整文档对象：
• id, title, author, url, source_url, summary
• published_date, image_url, location, category
• tags, created_at, updated_at
• content：对大语言模型友好的文本内容（通过 r.jina.ai 从 source_url 或 url 转换而来）

readwise_update_document

更新 Readwise Reader 中的文档。 参数：

• id（必需）：要更新的文档 ID。
• title（可选）：新的标题。
• author（可选）：新的作者。
• summary（可选）：新的摘要。
• published_date（可选）：新的发布日期（ISO 8601 格式）。
• image_url（可选）：新的图像 URL。
• location（可选）：新的位置。
• category（可选）：新的类别。

readwise_delete_document

从 Readwise Reader 中删除文档。 参数：

• id（必需）：要删除的文档 ID。

readwise_list_tags

列出 Readwise Reader 中的所有标签。 参数：无

readwise_topic_search

使用正则表达式在 Readwise Reader 中按主题搜索文档，匹配标题、摘要、笔记和标签。 参数：

• searchTerms（必需）：用于匹配文档内容的搜索词数组（不区分大小写的正则表达式匹配）。 返回值： 包含匹配文档的搜索结果，包括：
• 使用的搜索词。
• 匹配的总数。
• 包含所有可用元数据的完整文档对象（与 readwise_list_documents 返回的字段相同）。

API 文档

有关 Readwise Reader API 端点、参数和示例的详细信息，请参考官方 API 文档： 📖 Readwise Reader API 文档 此 MCP 服务器实现了官方文档中描述的所有核心端点。

认证

服务器需要通过 READWISE_TOKEN 环境变量提供 Readwise 访问令牌，该令牌用于对所有向 Readwise Reader 的 API 请求进行身份验证。 安全说明：令牌存储在你的 MCP 配置中，不会通过 Claude 或工具界面暴露。

速率限制

• 默认：每分钟 20 个请求。
• 文档创建/更新：每分钟 50 个请求。
• 429 响应包含 "Retry-After" 头部。

📄 许可证

本项目采用 MIT 许可证。