项目简介

Reader MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现。它充当您 Readwise Reader 个人资料库与 MCP 兼容的 LLM 客户端（如 Claude Desktop、VS Code 等）之间的桥梁。通过该服务器，LLM 可以通过标准化的方式访问您的 Readwise Reader 文档。

主要功能点

• 文档列表查询: 允许 LLM 查询 Readwise Reader 中的文档列表。
• 灵活的过滤: 支持按位置（收件箱、稍后阅读、短清单、归档、订阅源）和更新时间进行过滤。
• 内容包含选项: 可选择在查询结果中包含文档的 HTML 内容。
• 分页支持: 提供分页能力以处理大量文档列表。
• 工具暴露: 通过 MCP 标准将这些能力暴露为可调用的工具（例如 'list_documents' 工具）。

安装步骤

1. 克隆仓库: 将项目代码克隆到本地目录。
2. 安装 Python 和 uv: 确保您的系统安装了 Python 3.8+ 和 'uv' 工具 (推荐用于依赖管理和运行)。
3. 进入项目目录: 打开终端，切换到您克隆的项目根目录。
4. 安装依赖: 运行 'uv sync' 命令安装项目所需的依赖库。
5. 设置 Readwise API 访问令牌: 您需要一个 Readwise Reader API 访问令牌。将其设置为名为 'ACCESS_TOKEN' 的环境变量。或者，在项目根目录下创建一个 '.env' 文件，内容为 'ACCESS_TOKEN=您的令牌'。

服务器配置

MCP 服务器不是独立运行的应用程序，而是由 MCP 客户端根据配置启动和管理的。要在您的 MCP 客户端（如 Claude Desktop、VS Code 的 MCP 插件）中使用此服务器，您需要在客户端的 MCP 配置中添加一项。

配置通常是一个 JSON 结构，需要指定：

• 服务器名称: 用于在客户端标识此服务器的名称（例如：'reader'）。
• 启动命令 ('command'): 客户端用于启动此服务器进程的命令。例如，如果您使用 'uv' 运行，命令可能是 'uv'。
• 命令参数 ('args'): 传递给启动命令的参数。这通常包括指向 'main.py' 文件所在的目录和运行命令，例如 '["--directory", "/绝对/路径/到/项目/目录", "run", "main.py"]'。您需要将 '/绝对/路径/到/项目/目录' 替换为您实际的项目路径。
• 环境变量 ('env'): 如果您没有在 '.env' 文件中设置 'ACCESS_TOKEN'，可以在这里通过环境变量传递。配置项可能类似 '{"ACCESS_TOKEN": "您的令牌"}'。

请查阅您的 MCP 客户端文档，了解具体的配置文件的位置和格式。

基本使用方法

正确配置并由客户端启动后，LLM 就可以通过 MCP 调用该服务器暴露的工具。例如，LLM 可以调用 'list_documents' 工具，并提供参数（如 'location'、'updatedAfter' 等）来获取 Readwise Reader 中的文档信息。具体的交互方式取决于您的 MCP 客户端和 LLM 模型的能力。