Readwise MCP Enhanced

🚀 Readwise MCP Enhanced

Readwise MCP Enhancedは、Readwise Readerのドキュメント管理とReadwiseのハイライト機能を統合した包括的なモデルコンテキストプロトコル（MCP）サーバーです。Claude Desktop、Continue、およびMCP互換のAIツールすべてで使用できます。TypeScriptで構築され、高度なテキスト処理、スマートなコンテンツコントロール、コンテキスト最適化されたレスポンスを備えています。

🚀 これは何か

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

• 完全なReadwise Reader API - ドキュメントの保存、管理、検索
• 完全なReadwise Highlights API - すべてのハイライト、書籍、および毎日の復習にアクセス
• AIによるテキスト処理 - インテリジェントな単語分割とコンテンツ抽出
• コンテキスト最適化 - 機能を維持しながらトークン使用量を94％削減
• スマートなコンテンツコントロール - 高度なフィルタリングとページネーションでコンテキストの爆発を防ぐ

公式のReadwise MCPと同等ですが、より効率的で機能が充実しています。すべてのMCPクライアントと互換性があります。

✨ 主な機能

📚 強化されたリーダー管理

• スマートなコンテンツ抽出：ページネーション、キーワードフィルタリング、長さ制限
• AIによるテキスト処理：自動単語分割で結合された単語を修正
• パフォーマンスコントロール：高コストの操作に対する警告とガイダンスを内蔵
• 柔軟なフィルタリング：場所、カテゴリ、タグ、日付、およびカスタム基準によるフィルタリング

🎯 完全なハイライトエコシステム

• 毎日の復習：間隔学習システム
• 高度な検索：関連性スコア付きのフィールド固有のクエリ
• 書籍管理：ハイライト数とフィルタリングを含む完全なメタデータ
• エクスポートとバックアップ：大量のハイライト分析と増分同期
• 手動作成：完全なメタデータをサポートしてハイライトを追加

⚡ 本番環境での卓越性

• コンテキスト最適化：トークン使用量を94％削減（25,600 → 1,600トークン）
• デュアル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

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個）

📚 リーダーツール（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": "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クライアントシステム

// シームレスなAPI切り替え
v2 API: ハイライト、書籍、毎日の復習、エクスポート
v3 API: リーダードキュメント、タグ、検索

コンテキスト効率的な設計

• アイテムごとに最小限のデータで無制限の結果
• 効率的な解析のためのLLM最適化レスポンス
• 完全な推論能力を維持する構造化JSON

本番環境での準備完了

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

⚙️ APIのカバレッジ

Readwise Reader API (v3)

• ✅ ドキュメント：保存、リスト、更新、削除
• ✅ タグ：リストとフィルタリング
• ✅ コンテンツ：コントロール付きのスマートな抽出
• ✅ 検索：強化されたトピック検索

Readwise Highlights API (v2)

• ✅ ハイライト：リスト、作成、検索、エクスポート
• ✅ 書籍：メタデータとフィルタリングを含むリスト
• ✅ 毎日の復習：間隔学習システム
• ✅ 高度な検索：フィールド固有のクエリ

🔐 認証とセキュリティ

• シングルトークン：両方のAPIに1つのReadwiseトークン
• 環境変数：READWISE_TOKENを介した安全なトークン保存
• トークンの露出なし：MCPクライアントまたはツールのインターフェイスを介してトークンが露出されることはありません。

📈 レート制限

• リーダーAPI：20リクエスト/分（デフォルト）、50/分（CREATE/UPDATE）
• ハイライトAPI：標準のReadwise制限で自動的なリトライ処理
• スマートなハンドリング：429レスポンスには「Retry-After」ヘッダーの処理が含まれます。

💻 使用例

スマートなコンテンツ抽出

// 大きなドキュメントをページネーションする
readwise_list_documents({
  withFullContent: true,
  contentMaxLength: 5000,
  contentStartOffset: 0,
  contentFilterKeywords: ["machine learning", "AI"]
})

包括的な検索

// ドキュメントとハイライトを検索する
readwise_search_highlights({
  textQuery: "productivity habits",
  fieldQueries: [
    { field: "document_author", searchTerm: "James Clear" }
  ],
  limit: 10
})

毎日の学習ワークフロー

// 間隔学習のための毎日の復習を取得する
readwise_get_daily_review()

// 深い学習のために関連するハイライトを検索する
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

🔄 基本的なリーダーMCPからの移行

この統合型MCPは完全に下位互換性があります。すべての既存のリーダーツールは変更なしで動作し、7つの新しいハイライトツールが追加されます。

破壊的な変更はありません - 機能が強化され、パフォーマンスが向上します。

🌟 なぜこのMCPを選ぶべきか

公式のReadwise MCPと比較

• ✅ コンテキスト効率が高い（94％削減）
• ✅ 統一されたインターフェイス（リーダー + ハイライト）
• ✅ スマートなコンテンツコントロール（ページネーション、フィルタリング）
• ✅ AIによるテキスト処理
• ✅ 最小限の冗長性で無制限の結果

基本的なリーダーMCPと比較

• ✅ 完全なハイライトエコシステム（7つの新しいツール）
• ✅ 高度な検索機能
• ✅ 本番環境でのパフォーマンス
• ✅ コンテキスト最適化

📄 ライセンス

MIT

🙏 謝辞

edricgan/Readwise-Reader-MCPを基盤として構築され、大幅な機能強化が施されています。

• スマートなコンテンツコントロールによる強化されたリーダー機能
• 公式MCPと同等の完全なハイライト統合
• 単語分割を含むAIによるテキスト処理
• 本番環境での効率のためのコンテキスト最適化
• デュアルAPIをシームレスに統合する統一アーキテクチャ

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