Readwise Reader MCP

🚀 Readwise Reader MCP Server

このサーバーは、TypeScriptと公式Claude SDKを使用して構築された、Readwise Reader API用のModel Context Protocol (MCP) サーバーです。Readwise Readerのドキュメント管理やタグ管理などの機能を提供します。

🚀 クイックスタート

このReadwise Reader MCPサーバーを使用することで、Readwise Readerのドキュメントを管理することができます。以下のセクションで、主な機能、インストール方法、設定方法、利用可能なツールなどについて説明します。

✨ 主な機能

• セキュアな認証：トークンの保存に環境変数を使用します。
• ドキュメント管理：完全なメタデータを持つドキュメントの保存、一覧表示、更新、削除が可能です。
• タグ管理：タグでの一覧表示とフィルタリングができます。
• 高度なフィルタリング：場所、カテゴリ、タグなどでドキュメントをフィルタリングできます。
• ページネーションサポート：大量のドキュメントコレクションを扱うことができます。
• LLMに適したコンテンツ：HTMLコンテンツはr.jina.aiを使用して自動的にクリーンなテキストに変換されます。
• 完全なデータアクセス：コンテンツ、メタデータ、タイムスタンプを含む完全なドキュメント情報を返します。

📦 インストール

npm install
npm run build

📚 詳細ドキュメント

設定方法

Claude Desktopを使用する場合

1. MCPサーバーをビルドします：

   npm install
   npm run build
   

2. Readwiseアクセストークンを取得します：https://readwise.io/access_token

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からドキュメントを一覧表示し、オプションでフィルタリングできます。メタデータとLLMに適したテキストコンテンツを含む完全なドキュメント情報を返します。

パラメーター:

• 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: LLMに適したテキストコンテンツ (source_urlまたはurlからr.jina.aiを介して変換された)

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 と同じフィールド)

認証

サーバーは、READWISE_TOKEN 環境変数を介してReadwiseアクセストークンを提供する必要があります。このトークンは、Readwise ReaderへのすべてのAPIリクエストを認証するために使用されます。

セキュリティに関する注意：トークンはあなたのMCP設定に保存され、Claudeやツールのインターフェースを通じて決して公開されません。

レート制限

• デフォルト: 20リクエスト/分
• ドキュメントの作成/更新: 50リクエスト/分
• 429レスポンスには "Retry-After" ヘッダーが含まれます。

APIドキュメント

Readwise Reader APIのエンドポイント、パラメーター、および例に関する詳細情報については、公式APIドキュメントを参照してください：

📖 Readwise Reader API Documentation

このMCPサーバーは、公式ドキュメントに記載されているすべてのコアエンドポイントを実装しています。

📄 ライセンス

MITライセンスの下で提供されています。