Readwise文档集成工具

readwise mcp

叉子 readwise mcp增强，塑造了我实际阅读和研究的方式。

为什么这个叉子存在

我做了很多阅读——学术论文、研究PDF、课程作业和文化保护项目中的文章。Readwise是我收集和注释这些材料的地方，我希望克劳德可以直接访问它。

Arnaldo De Lisio的原始MCP做得很好，但上传的PDF对我不起作用。API从我直接上传的文件中获取内容时返回401个错误。事实证明，修复很简单：Readwise为上传的内容提供了临时S3链接，而原始版本并没有请求它们。这个叉子确实如此。

这是直接的变化。但我之所以坚持这一点，是因为我想要一个适合我工作方式的Readwise集成——研究繁重，PDF繁重，在我思考想法的时候，经常把内容拉进与克劳德的对话中。如果上游更改破坏了该工作流中的某些内容，我将在此处修复它。如果我需要的功能对一般情况没有意义，它们也会在这里出现。

我改变了什么（到目前为止）

在获取完整文档内容时，此分叉：

• 请求： withRawSourceUrl=true 来自Readwise API
• 对上传的文档使用S3预签名URL（绕过身份验证问题）
• 如果S3不可用，则优雅地回退到其他方法

其他一切都和原版一样。

安装

来源

git clone https://github.com/odysseyalive/readwise-mcp.git
cd readwise-mcp
npm install
npm run build

配置

从以下地址获取Readwise令牌https://readwise.io/access_token

克劳德代码：

claude mcp add readwise-mcp --transport stdio \
  --env READWISE_TOKEN=your_token_here \
  --scope user \
  -- node /path/to/readwise-mcp/dist/index.js

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json 在Mac上）：

{
  "mcpServers": {
    "readwise-mcp": {
      "command": "node",
      "args": ["/path/to/readwise-mcp/dist/index.js"],
      "env": {
        "READWISE_TOKEN": "your_token_here"
      }
    }
  }
}

它能做什么

原版中的所有13个工具，包括：

阅读器工具： 保存、列出、更新、删除文档。按主题搜索。具有分页和关键字过滤功能的智能内容提取。

突出显示工具： 列出和搜索亮点，每天审查间隔重复，图书管理，导出备份。

请参阅 原始README 获取完整的工具文档。

学分

此分支通过以下方式构建工作：

• 阿纳尔多·德·利西奥 --创建 readwise mcp增强，它将阅读器和亮点整合到一个具有智能内容控制和上下文优化的MCP中。这就是这里的基础。

• edricgsh --建成 可读阅读器MCP，阿纳尔多所建立的项目。

许可证

麻省理工学院（与上游相同）