Readwise MCP

🚀 Readwise MCP サーバー

このサーバーは、Readwise ライブラリへのアクセスとインタラクションを可能にするモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• Readwise 内のハイライト内容にアクセスする
• 自然言語クエリを使用してハイライト内容を検索する
• Readwise 内の書籍情報を取得する
• Readwise 内のドキュメント資料を取得する
• Readwise からのハイライト内容を検索し、要約、分析、関連検索、質問生成をサポートする

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/your-repository.git
cd your-repository

2. 依存関係をインストールする

npm install

3. プロジェクトをビルドする

npm run build

📚 設定

1. 設定ウィザードを実行する

npm run setup

2. API キーを設定する

• config.js ファイルを開く
• Readwise API キーを追加する
• ファイルを保存する

💻 使用例

CLI 使用例

# ハイライト内容を取得する
npm run get-highlights -- [--page=1 --limit=10]

# ハイライト内容を検索する
npm run search-highlights -- [--query="あなたの検索語" --exact]

API コード例

const { MCPClient } = require('@readwise/mcp-client');

// クライアントを初期化する
const client = new MCPClient('your-api-key');

// ハイライト内容を取得する
async function getHighlights() {
    try {
        const response = await client.getHighlights({
            page: 1,
            limit: 10
        });
        console.log(response.data);
    } catch (error) {
        console.error('ハイライト内容の取得に失敗しました:', error.message);
    }
}

// ハイライト内容を検索する
async function searchHighlights() {
    try {
        const response = await client.searchHighlights({
            query: 'あなたの検索語',
            exact: true
        });
        console.log(response.data);
    } catch (error) {
        console.error('ハイライトの検索に失敗しました:', error.message);
    }
}

🔧 テスト方法

1. 自動化テストを実行する

npm test

2. 手動テストツールを使用する

• get_highlights ツールを使用してハイライト内容を取得する
• search_highlights ツールを使用してハイライト内容を検索する

3. Mock テスト環境を使用する

npm run test-mock

🛠️ 利用可能なツール

• 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 エラー状況に対して具体的なエラーメッセージを提供する
• すべてのツールとヒントで一貫したエラー形式を維持する
• プロトコルフローを妨げないトランスポート感知ロギングを行う

🛠️ 開発情報

# プロジェクトをビルドする
npm run build

# テストを実行する
npm test

# 開発モードで起動する（自動リロード）
npm run dev:watch

# コードチェックを実行する
npm run lint

📄 ライセンス

MIT