读者 MCP 服务器

概述

一个模型上下文协议 (MCP) 服务器，可与您的Readwise 阅读器库无缝集成。此服务器支持兼容 MCP 的客户端（例如 Claude 和 VS Code）与您的阅读器库进行交互，提供文档列表、检索和更新功能。它充当 MCP 客户端与您在 Readwise 阅读器中的个人知识库之间的桥梁。

Related MCP server: MCP Fetch

成分

工具

• list_documents

  • 通过灵活的过滤和分页功能列出阅读器中的文档。

  • 输入：

    • location （字符串，可选）：要筛选的文件夹。以下选项之一： new 、 later 、 shortlist 、 archive 、 feed 。

    • updatedAfter （字符串，可选）：仅返回在此 ISO8601 时间戳之后更新的文档。

    • withContent （布尔值，可选）：如果为真，则在结果中包含 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": {
        "ACCESS_TOKEN": "your_readwise_access_token"
      }
    }
  }
}

• 将/absolute/path/to/your/reader/server替换为此项目目录的实际路径。

• 将your_readwise_access_token替换为您的实际 Readwise Reader API 访问令牌。

• 或者，您可以在项目目录中的.env文件中指定ACCESS_TOKEN 。

有关更多信息，请参阅Readwise Reader API 文档和MCP 文档。