Kiseki-Labs-Readwise-MCP

Kiseki-Labs-Readwise-MCP

概要

Kiseki-Labs-Readwise-MCP は、Readwise API と連携するために設計された Model Context Protocol（MCP）サーバーです。

LLM が Readwise のドキュメントやハイライトにプログラムからアクセスし、操作できるようにします。このサーバーは Kiseki Labs が開発しています。

インストール

1. リポジトリをクローンします：

   git clone <your-repository-url>
   cd readwise_mcp
   

2. uv で依存関係を初期化します (uv がインストールされていることを前提とします)

   uv sync
   

設定

このサーバーを動作させるには Readwise API キーが必要です。

1. Readwise から API キーを取得します。
2. プロジェクトのルートディレクトリに .env ファイルを作成します。
3. API キーを .env ファイルに追加します：

   READWISE_API_KEY=your_readwise_api_key_here
   

   サーバーは python-dotenv を使用して、実行時にこの変数を自動で読み込みます。

利用可能なツール

サーバーでは、以下のツールを利用できます：

• find_readwise_document_by_name(document_name: str) -> Book | None：Readwise 内から、名前が完全に一致する特定のドキュメントを検索します。
• list_readwise_documents_by_filters(document_category: str = "", from_date: Optional[date] = None, to_date: Optional[date] = None) -> List[Book]：カテゴリ（例：'books'、'articles'）および／または日付範囲に基づいてドキュメントを一覧表示します。少なくとも1つのフィルターが必要です。
• get_readwise_highlights_by_document_ids(document_ids: List[int]) -> List[Highlight]：指定したドキュメント ID のリストに関連付けられたすべてのハイライトを取得します。
• get_readwise_highlights_by_filters(from_date: Optional[date] = None, to_date: Optional[date] = None, tag_names: List[str] = []) -> List[Highlight]：日付範囲および／またはタグのリストに基づいてハイライトを取得します。少なくとも1つのフィルターが必要です。

(注：Book と Highlight は、readwise_mcp.types モジュールで定義されているデータ構造を指します。)

サーバーの実行

開発モード

MCP サーバーを開発モードで実行するには、プロジェクトのルートディレクトリから次のコマンドを実行します：

uv run mcp dev server.py

ホストとポートを変更していない場合、開発サーバーは起動後、デフォルトで http://127.0.0.1:6274/ からオンラインでアクセスできるようになります。

Claude で MCP サーバーをインストールする

MacBook で、お好みのテキストエディターを使って以下のファイルを開きます：

~/Library/Application\ Support/Claude/claude_desktop_config.json

たとえば、vim を使ってこのファイルを開くには、次のコマンドを実行します：

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

次に、以下の例のように mcpServers オブジェクトの下に適切なエントリを追加します：

"mcpServers": {
    "Kiseki-Labs-Readwise-MCP": {
      "command": "/Users/eddie/.pyenv/shims/uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "/Users/eddie/Development/AI/mcp_servers/readwise_mcp/server.py"
      ]
    }
    ...

変更を加えたファイルを保存します。 最後に、Claude を再起動します。再起動後、Kiseki-Labs-Readwise-MCP MCP サーバーが利用可能になります。