使用说明

项目简介

Readwise Chat 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当了 Claude Desktop 等 LLM 客户端与 Readwise Reader 知识库之间的桥梁。通过 Readwise Chat，您可以让 LLM 访问和操作您的 Readwise Reader 文档，实现更智能的对话和知识检索功能。

主要功能点

• 资源管理 (Resources): 将您的 Readwise Reader 文档库中的文档作为资源进行托管和管理，允许 LLM 客户端访问文档信息。目前资源功能仍在开发中。
• 工具 (Tools): 提供以下工具，扩展 LLM 的能力：
  • 'add-document': 向您的 Readwise Reader 文档库添加新的文档，需要提供文档 URL。
  • 'get-document': 列出您的 Readwise Reader 文档库中的文档，可以根据文档位置 (location)、类别 (category) 和更新时间 (updated_after) 进行筛选。
• Prompt 模板 (Prompts): 支持预定义的 Prompt 模板，用于定制与 LLM 的交互模式。Prompt 功能目前仍在开发中。

安装步骤

1. Claude Desktop 配置:
   • 打开 Claude Desktop 客户端的配置文件 'claude_desktop_config.json'。
     • MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
     • Windows: '%APPDATA%/Claude/claude_desktop_config.json'
2. 添加 MCP 服务器配置:
   • 在 'claude_desktop_config.json' 文件中的 '"mcpServers"' 字段下，添加 'readwise-chat' 服务器的配置信息。根据您的使用场景选择 "Development/Unpublished Servers Configuration" (开发/未发布服务器配置) 或 "Published Servers Configuration" (已发布服务器配置)。

服务器配置

将以下 JSON 配置添加到 'claude_desktop_config.json' 文件的 '"mcpServers"' 字段中。

Development/Unpublished Servers Configuration (开发/未发布服务器配置)

用于开发和调试阶段。需要您本地安装并运行 'readwise-chat' 服务器。

"mcpServers": {
  "readwise-chat": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/readwise-chat",  //  请替换为您的 'readwise-chat' 项目的本地路径
      "run",
      "readwise-chat"
    ]
  }
}

Published Servers Configuration (已发布服务器配置)

用于部署和发布后的场景。假设 'readwise-chat' 服务器已打包并可通过 'uvx readwise-chat' 命令直接运行。

"mcpServers": {
  "readwise-chat": {
    "command": "uvx",
    "args": [
      "readwise-chat"
    ]
  }
}

基本使用方法

1. 确保已按照上述步骤配置 Claude Desktop 客户端。
2. 启动 'readwise-chat' MCP 服务器（如果您选择 "Development/Unpublished Servers Configuration"，则需要在本地项目目录下运行服务器）。
3. 在 Claude Desktop 中，您应该能够连接到 'readwise-chat' 服务器。
4. 通过 Claude Desktop 与您的 Readwise Reader 文档进行对话和交互，例如：
   • 使用 'add-document' 工具添加新的文档到 Reader。
   • 使用 'get-document' 工具查询和获取 Reader 中的文档列表。
   • 利用 Prompt 功能（如果已实现）定制与文档交互的方式。

注意: Readwise Chat 项目和 MCP 协议本身都处于积极开发阶段，部分高级功能可能仍在开发中。