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 許可證。