Reader Server

Reader MCP 服务

概览

一个与您的 Readwise Reader 书库无缝集成的模型上下文协议（MCP）服务。此服务使 Claude 和 VS Code 等兼容 MCP 的客户端能够与您的 Reader 书库交互，提供文档列表、检索和更新功能。它充当 MCP 客户端与您在 Readwise Reader 中的个人知识库之间的桥梁。

组件

工具

• list_documents
  • 使用灵活的筛选和分页功能列出 Reader 中的文档。
  • 输入：
    • location（字符串，可选）：用于筛选的文件夹。可选值为 new、later、shortlist、archive、feed。
    • updatedAfter（字符串，可选）：仅返回在此 ISO8601 时间戳之后更新的文档。
    • withContent（布尔值，可选）：如果为 true，则在结果中包含 HTML 内容（默认为 false）。
    • pageCursor（字符串，可选）：用于获取下一页的分页游标。
  • 返回：
    • 包含文档列表的 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、保存文章或管理阅读列表时，该技能将自动触发。