Kiseki Labs Readwise MCP

🚀 Kiseki-Labs-Readwise-MCP サーバー

Kiseki-Labs-Readwise-MCP は、Readwise API との相互作用を目的としたモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用することで、言語モデルが Readwise のドキュメントやハイライト内容にアクセスし、操作することができます。本サーバーは Kiseki Labs によって開発されています。

🚀 クイックスタート

Kiseki-Labs-Readwise-MCP は、Readwise API とのやり取りを可能にする MCP サーバーです。言語モデルが Readwise のドキュメントやハイライトを操作できるようになります。

✨ 主な機能

• 言語モデルが Readwise のドキュメントとハイライト内容にアクセスできるようにする。
• さまざまなフィルターを使用して、ドキュメントやハイライトを検索するためのツールを提供する。

📦 インストール

リポジトリのクローン

git clone <your-repository-url>
cd readwise_mcp

uv を使用した依存関係の初期化

(前提として、uv がインストールされていることを仮定します)

uv sync

📚 ドキュメント

設定

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

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

READWISE_API_KEY=your_readwise_api_key_here

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

利用可能なツール

サーバーは、以下のツールを公開しています。

• find_readwise_document_by_name(document_name: str) -> Book | None: ドキュメントの正確な名前を指定して特定のドキュメントを検索します。
• 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 サーバーが利用可能になります。