Readwise MCP サーバー
Readwise ライブラリにアクセスして対話するための Model Context Protocol (MCP) サーバー。
特徴
Readwise ライブラリのハイライトにアクセス
自然言語クエリを使用してハイライトを検索する
図書館から本や文書を入手する
Claude やその他の MCP 対応アシスタントとのシームレスな統合
ハイライト分析のための強化されたプロンプト機能
トランスポートを考慮したログ記録システム
堅牢なエラー処理と検証
適切な request_id 処理による MCP プロトコル準拠
監視用のヘルスチェックエンドポイント
APIキー検証を備えたセットアップウィザードの改善
Related MCP server: Reader MCP Server
プロジェクト構造
このリポジトリは、次の主要なディレクトリに編成されています。
src/ : Readwise MCP サーバーのメインソースコード
test-scripts/ : MCP サーバーの機能を検証するためのテスト スクリプトとユーティリティ
smart-mcp-test.sh: stdio と SSE トランスポートの両方のメインテストスクリプトrun-simple-server.sh: シンプルな MCP サーバーを実行するスクリプト完全なドキュメントについては
test-scripts/README.mdを参照してください。
examples/ : 実装例とコードサンプル
examples/mcp-implementations/: 基本的なMCPサーバーの実装examples/test-clients/: クライアント側テストスクリプト完全なドキュメントについては
examples/README.mdを参照してください。
dist/ : コンパイルされたJavaScript出力（生成済み）
scripts/ : 開発とテストのためのユーティリティスクリプト
インストール
設定
サーバーを使用する前に、Readwise API キーを設定する必要があります。
API キーはhttps://readwise.io/access_tokenから取得できます。
使用法
コマンドライン
API
MCP Inspectorによるテスト
このプロジェクトには、MCPインスペクターを使ったテストのための組み込みサポートが含まれています。インスペクターの実行には、TypeScriptスクリプトまたはシェルスクリプトを使用できます。
自動テスト
すべてのツールとプロンプトを検証する自動テスト スイートを実行します。
テスト スイートでは次の点を検証します。
サーバーの起動と接続
ツールの可用性と応答
プロンプト機能
エラー処理
応答形式の準拠
各テストでは、詳細な出力と合格/不合格のケースの概要が提供されます。
手動テスト
シェルスクリプトの使用
TypeScriptスクリプトの使用
利用可能なオプション
-t, --transport <type>: トランスポートタイプ (stdio または sse)、デフォルト: stdio-p, --port <number>: SSEトランスポートのポート番号、デフォルト: 3001-d, --debug: デバッグモードを有効にする
インスペクターコマンドの例
特定のツールをテストします。
プロンプトをテストします。
利用可能なツールとプロンプトを一覧表示します。
Readwise APIキーなしでのテスト
Readwise API キーをお持ちでない場合、またはテストに実際の API キーを使用したくない場合は、模擬テスト機能を使用できます。
これは次のテスト スクリプトを実行します:
Readwise APIのモック実装を作成します
このモックAPIを使用してMCPサーバーをセットアップします
サンプルデータを使用してさまざまなエンドポイントをテストします
実際のAPIキーを必要とせずにサーバーの機能を検証します
モック実装には以下が含まれます。
サンプルブック、ハイライト、ドキュメント
現実的なテストのためのネットワーク遅延のシミュレーション
エラー処理テスト
利用可能なツール
get_highlights : Readwise ライブラリからハイライトを取得します
get_books : Readwise ライブラリから本を取得する
get_documents : Readwise ライブラリからドキュメントを取得する
search_highlights : Readwise ライブラリ内のハイライトを検索
利用可能なプロンプト
readwise_highlight : Readwise からのプロセスのハイライト
要約、分析、関連性の発見、質問の生成をサポートします
堅牢なエラー処理とパラメータ検証が含まれています
読みやすい形式でハイライトをフォーマットします
readwise_search : Readwise からのハイライトを検索して処理します
ソース情報を含むフォーマットされた検索結果を提供します
ユーザーフレンドリーなメッセージでAPIエラーを適切に処理します
必須パラメータの検証を含む
最近の改善点
強化されたMCPプロトコルコンプライアンス
すべてのレスポンスにおける request_id の適切な処理
MCPプロトコル仕様に対する受信リクエストの検証
MCPガイドラインに従った一貫したエラー応答形式
セットアップエクスペリエンスの改善
API キー検証を備えた対話型セットアップ ウィザード
構成の安全な保管
トラブルシューティングのための詳細なエラーメッセージ
堅牢なエラー処理
さまざまな API エラー条件に対する特定のエラー メッセージ
すべてのツールとプロンプトで一貫したエラー形式
プロトコルに干渉しないトランスポート対応のログ記録
発達
ライセンス
マサチューセッツ工科大学