AI导哈

Reader MCP 服务器

一个与Readwise Reader库无缝集成的模型上下文协议（MCP）服务器，为MCP兼容客户端（如Claude和VS Code）提供文档列表、检索和更新功能。

  • by xinthink
  • Python
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 xinthink/reader-mcp-server-py

使用说明

读取器MCP服务器

概述

一个模型上下文协议（MCP）服务器，与您的 Readwise阅读器 图书馆。此服务器使兼容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客户端一起使用

克劳德桌面/VS代码/其他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访问令牌。
  • 或者，您可以指定 READWISE_ACCESS_TOKEN 在一个 .env 位于项目目录中的文件。

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

阅读技巧

此存储库还包括通过HTTP请求直接与Readwise Reader API交互的独立技能。该技能提供了在不需要MCP服务器的情况下使用阅读器API的知识和示例。

特性

  • 列出、创建、更新和删除文档
  • API全面覆盖（列表、保存、更新、删除、标记、批量操作）
  • 身份验证和速率限制指南
  • Python中的代码示例

安装

npx skills add xinthink/reader-mcp-server --skill reader

有关安装和使用技能的更多信息，请参阅 Vercel Labs技能文档.

用法

安装后，当您询问Readwise Reader、保存文章或管理阅读列表时，该技能将自动触发。

相关 MCP