Reader MCP 服务器

概述

这是一个模型上下文协议（MCP）服务器，可以无缝集成到您的 Readwise Reader 库中。该服务器使支持MCP的客户端（如Claude和VS Code）能够与您的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 (本地服务器)

json
{
"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 文档。