Reader Server

Reader MCP Server

概要

Readwise Readerライブラリとシームレスに連携するModel Context Protocol（MCP）サーバーです。このサーバーを使用すると、ClaudeやVS CodeなどのMCP対応クライアントからReaderライブラリを操作でき、ドキュメントの一覧表示、取得、更新が可能になります。MCPクライアントと、Readwise Readerにある個人用ナレッジリポジトリとの橋渡しをします。

コンポーネント

ツール

• list_documents
  • 柔軟なフィルタリングとページネーションを使って、Readerのドキュメントを一覧表示します。
  • 入力：
    • location（string、任意）：フィルタリングするフォルダーです。new、later、shortlist、archive、feedのいずれかを指定します。
    • updatedAfter（string、任意）：このISO8601タイムスタンプより後に更新されたドキュメントのみを返します。
    • withContent（boolean、任意）：trueの場合、結果にHTMLコンテンツを含めます（デフォルト：false）。
    • pageCursor（string、任意）：次のページを取得するためのページネーションカーソルです。
  • 戻り値：
    • ドキュメントの一覧を含むJSONオブジェクトです。各ドキュメントにはメタデータと（任意で）コンテンツが含まれ、ページネーション情報も含まれます。

MCP クライアントでの使用方法

Claude Desktop / VS Code / その他の MCP クライアント

このサーバーをClaude Desktop、VS Code、または任意のMCP対応クライアントで使用するには、クライアントの設定（例：claude_desktop_config.jsonまたは.vscode/mcp.json）に次の設定を追加します。

uv（ローカルサーバー）

{
  "mcpServers": {
    "reader": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/reader/server",
        "run",
        "main.py"
      ],
      "env": {
        "READWISE_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

• /absolute/path/to/your/reader/serverを、このプロジェクトディレクトリの実際のパスに置き換えてください。
• your-token-hereを、実際のReadwise Reader APIアクセストークンに置き換えてください。
• または、プロジェクトディレクトリにある.envファイルでREADWISE_ACCESS_TOKENを指定できます。

---

詳しくは、Readwise Reader APIのドキュメントおよびMCPのドキュメントをご覧ください。

---

Reader スキル

このリポジトリには、HTTPリクエストを介してReadwise Reader APIを直接操作するための、独立したスキルも含まれています。このスキルでは、MCPサーバーを使わずにReader APIを利用するための知識と例を提供します。

機能

• ドキュメントの一覧表示、作成、更新、削除
• APIの全機能をカバー（一覧表示、保存、更新、削除、タグ、一括操作）
• 認証とレート制限に関するガイダンス
• Pythonのコード例

インストール

npx skills add xinthink/reader-mcp-server --skill reader

スキルのインストールと使用方法について詳しくは、Vercel Labs Skillsのドキュメントをご覧ください。

使用方法

インストールすると、Readwise Reader、記事の保存、または読書リストの管理について質問したときに、スキルが自動的に起動します。