Readwise Enhanced Mcp

---

status: published category: mcp-server author: arnaldo-delisio published_npm: true npm_package: readwise-mcp-enhanced published_directories: [] production_url: null last_active: 2026-01-26

Readwise MCP Enhanced

Readwise Readerのドキュメント管理と、Readwise highlightsの全機能を統合した包括的なModel Context Protocol（MCP）サーバーです。Claude Desktop、Continue、およびMCP対応のあらゆるAIツールで動作します。TypeScriptで構築されており、高度なテキスト処理、スマートなコンテンツ制御、コンテキストに最適化された応答を備えています。

🚀 これは何か

初の統合型MCPで、以下を組み合わせています。

• Readwise Reader APIの全機能 - ドキュメントの保存、管理、検索
• Readwise Highlights APIの全機能 - すべてのハイライト、書籍、デイリーレビューへのアクセス
• AIを活用したテキスト処理 - インテリジェントな単語分割とコンテンツ抽出
• コンテキストの最適化 - 機能をすべて維持しながら、トークン使用量を94％削減
• スマートなコンテンツ制御 - 高度なフィルタリングとページネーションでコンテキストの肥大化を防止

公式のReadwise MCPと同等の機能を、より効率的かつ豊富な機能で提供します。すべてのMCPクライアントに対応しています。

---

✨ 主な機能

📚 強化されたReader管理

• スマートなコンテンツ抽出：ページネーション、キーワードフィルタリング、長さ制限
• AIを活用したテキスト処理：自動的に単語を分割し、連結された単語を修正
• パフォーマンス制御：負荷の高い操作に対する警告とガイダンスを内蔵
• 柔軟なフィルタリング：場所、カテゴリ、タグ、日付、カスタム条件による絞り込み

🎯 ハイライトの包括的なエコシステム

• デイリーレビュー：間隔反復学習システム
• 高度な検索：関連度スコア付きのフィールド別クエリ
• 書籍管理：ハイライト数やフィルタリングを含むすべてのメタデータ
• エクスポートとバックアップ：ハイライトの一括分析と増分同期
• 手動作成：すべてのメタデータに対応したハイライトの追加

⚡ 本番環境での高い信頼性

• コンテキスト最適化：トークン使用量を94％削減（25,600 → 1,600トークン）
• デュアルAPIアーキテクチャ：v2（highlights）とv3（Reader）をシームレスに統合
• 無制限の結果：人為的な制限を設けず、アイテムごとに効率よくデータを提供
• 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

2. 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"
         }
       }
     }
   }
   

3. MCPクライアントを再起動します（Claude Desktop、Continueなど）。

---

📖 利用可能なツール（全13種類）

📚 Readerツール（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

Reader ライブラリからドキュメントを削除します。

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％ 削減：

ツール	最適化前	最適化後	削減率
ハイライトの一覧表示（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 クライアントシステム

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

コンテキスト効率を重視した設計

• 各項目のデータ量を最小限に抑えながら、結果数は無制限
• 効率的な解析に向けて最適化された LLM 応答
• 推論機能をすべて維持する構造化 JSON

本番環境対応

• 適切な TypeScript 定義を備えた ES モジュール標準
• ロギングとエラー処理が MCP プロトコルに準拠
• 包括的なレート制限と適切なフォールバック

---

⚙️ API 対応範囲

Readwise Reader API（v3）

• ✅ ドキュメント：保存、一覧表示、更新、削除
• ✅ タグ：一覧表示とフィルタリング
• ✅ コンテンツ：制御可能なスマート抽出
• ✅ 検索：強化されたトピック検索

Readwise Highlights API（v2）

• ✅ ハイライト：一覧表示、作成、検索、エクスポート
• ✅ 書籍：メタデータとフィルタリングを含む一覧表示
• ✅ デイリーレビュー：間隔反復システム
• ✅ 高度な検索：フィールド別クエリ

---

🔐 認証とセキュリティ

• 単一トークン：両方の API に 1 つの Readwise トークンを使用
• 環境変数：READWISE_TOKEN を使用した安全なトークン保存
• トークンの非公開：MCP クライアントやツールインターフェースを通じて公開されることはありません

---

📈 レート制限

• Reader API：20 リクエスト/分（デフォルト）、50 リクエスト/分（CREATE/UPDATE）
• Highlights API：自動的な Retry-After 処理を備えた、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"
}

主な追加項目：AI による単語分割のための wordsninja

---

🔄 Basic Reader MCP からの移行

この統合 MCP は完全な後方互換性を備えています。既存の Reader ツールはすべて変更なしで動作し、新たに 7 つの Highlights ツールが追加されます。

互換性を損なう変更はありません。機能が強化され、パフォーマンスが向上します。

---

🌟 この MCP を選ぶ理由

公式 Readwise MCP との比較

• ✅ コンテキスト効率が向上（94% 削減）
• ✅ 統合インターフェース（Reader + Highlights）
• ✅ スマートなコンテンツ制御（ページネーション、フィルタリング）
• ✅ AI によるテキスト処理
• ✅ 最小限の冗長性で無制限の結果

Basic Reader MCP との比較

• ✅ ハイライト機能を網羅（新たに 7 つのツール）
• ✅ 高度な検索機能
• ✅ 本番環境に対応したパフォーマンス
• ✅ コンテキストの最適化

---

📄 ライセンス

MIT

---

🙏 謝辞

edricgan/Readwise-Reader-MCP を基盤として、以下の大幅な機能強化を行いました。

• スマートなコンテンツ制御によるReader 機能の強化
• 公式 MCP と同等のHighlights との完全な統合
• 単語分割を備えたAI によるテキスト処理
• 本番環境での効率性を高めるコンテキストの最適化
• 2 つの API をシームレスに統合する統一アーキテクチャ

これは、基本的なドキュメント管理から包括的で本番環境に対応した Readwise プラットフォームへの、完全な進化を実現したものです。 🚀