Readwise MCP Server 📚

将您的Readwise账户连接到Claude AI，并在对话中直接访问您所有的高亮内容、书籍和阅读列表！

✨ 您可以做什么？

设置完成后，您可以向Claude提问：

• “我的Readwise阅读列表里有什么？” - 查看所有保存的文章
• “显示我每日复习的高亮内容” - 获取间隔重复复习
• “搜索我的高亮内容中的‘生产力技巧’” - 查找特定的高亮内容
• “保存这篇文章：https://example.com” - 添加到您的阅读列表
• “列出所有标签” - 查看文档标签
• “导出所有高亮内容” - 备份整个图书馆

🚀 10分钟设置

您需要什么

• ✅ Readwise账户（在这里获取）
• ✅ Claude AI（Pro/Team/Enterprise - 任何支持MCP的计划）
• ✅ 免费的Render账户用于托管

第一步：获取您的Readwise令牌（1分钟）

1. 访问 https://readwise.io/access_token
2. 复制您的访问令牌
3. 保存好它

第二步：分叉并部署服务器（5分钟）

选项A：部署到Render（推荐）

1. 分叉此仓库：

   • 点击GitHub页面顶部的“Fork”按钮
   • 这会创建您自己的代码副本

2. 在Render注册（提供免费层级）

3. 创建新的Web服务：

   • 点击“New +” → “Web Service”
   • 选择“Connect a Git repository”
   • 从列表中选择您的分叉仓库

4. 配置：

   • 名称：readwise-mcp（或您选择的名称）
   • 运行时：Docker（自动检测）
   • 计划：免费

5. 添加环境变量（在Render仪表板中）：

   READWISE_TOKEN=<粘贴步骤1中的令牌>
   

   就这样！不需要API密钥。

6. 点击创建Web服务并等待约2分钟

选项B：其他平台

<details> <summary>Railway / Fly.io / Google Cloud Run</summary>

该服务器可以在支持Docker的任何平台上运行。请参见Dockerfile进行配置。

</details>

第三步：验证是否正在运行（1分钟）

访问：https://YOUR-SERVICE-NAME.onrender.com/health

您应该看到：

{
  "status": "healthy",
  "service": "readwise-mcp-enhanced",
  "authentication": "enabled"
}

✅ 如果您看到这个，就可以开始了！

第四步：连接到Claude（3分钟）

1. 在 https://claude.ai 打开 Claude AI

2. 转到设置 → 集成（或类似的MCP部分）

3. 添加MCP服务器：

   名称：Readwise
   URL：https://YOUR-SERVICE-NAME.onrender.com
   

   不需要API密钥！

4. 测试连接 - 应该显示“12个工具可用”

5. 保存，完成！🎉

第五步：开始使用！

尝试向Claude提问：

• “今天我保存了哪些内容到Readwise？”
• “展示我AI书籍的高亮内容”
• “获取我的每日复习”

📖 所有可用功能

阅读器工具（5个工具）

• 保存文档 - 将URL添加到您的阅读列表
• 列出文档 - 使用过滤器浏览（位置、类别、作者、日期）
• 更新文档 - 编辑标题、标签、笔记
• 删除文档 - 从库中移除
• 列出标签 - 查看所有标签

高亮工具（7个工具）

• 列出高亮内容 - 使用日期过滤器浏览
• 每日复习 - 间隔重复系统
• 搜索高亮内容 - 使用增强的MCP端点通过文本查询查找（带有矢量/语义搜索）
• 列出书籍 - 查看带有高亮数量的书籍
• 获取书籍高亮内容 - 特定书籍的所有高亮内容
• 导出高亮内容 - 备份所有内容
• 创建高亮内容 - 手动添加高亮内容

🚀 高级功能

• ✅ 增强的MCP搜索 - 使用Readwise的MCP端点和矢量/语义搜索以获得更好的结果
• ✅ 无限分页 - 获取所有数据
• ✅ 增量同步 - 获取仅新/更新的项目
• ✅ 智能过滤 - 按作者、站点、日期过滤
• ✅ 批量导出 - 备份整个图书馆

🆓 成本

个人使用完全免费：

• ✅ Render：每月750小时（全天候运行）
• ✅ 使用您现有的Readwise订阅
• ⚠️ 服务器在15分钟后“休眠”（首次请求唤醒需10秒）

可选升级：

• 💵 每月7美元用于Render Starter（始终在线，无休眠）

🛠️ 故障排除

“连接失败”在Claude

1. 访问 https://YOUR-SERVICE.onrender.com/health - 应返回健康状态
2. 验证Claude设置中的URL是否正确
3. 如果服务器处于休眠状态，请等待10秒（免费层级）

服务器响应时间长

• 免费层级在15分钟不活动后“休眠”
• 睡眠后第一次请求大约需要10秒唤醒
• 这是正常的 - 后续请求速度很快！

“Readwise API错误”

• 检查Render仪表板中的READWISE_TOKEN
• 在 https://readwise.io/access_token 验证令牌
• 令牌可能已过期 - 获取一个新令牌

仍需帮助？

• 📖 查看CLAUDE_AI_SETUP.md以获取详细的Claude设置
• 🚀 查看DEPLOYMENT.md以获取高级部署选项
• 🐛 打开一个问题

🔒 安全与隐私

• ✅ 所有请求通过HTTPS加密
• ✅ 您的Readwise令牌保留在您的服务器上（从未暴露给Claude）
• ✅ 开源 - 自行检查代码！
• ⚠️ 重要：您的服务器URL是公开的，但仅与您的Readwise令牌一起工作

保护您的秘密：

• 不要提交包含令牌的.env文件
• 不要分享您的Readwise令牌
• 只有您可以通过您的服务器访问您的数据

🧪 开发者

本地运行

# 安装依赖
pip install -r requirements.txt

# 配置
cp .env.example .env
# 编辑.env文件以包含您的令牌

# 运行
python main.py

# 测试
python test_all_tools.py

Docker

docker build -t readwise-mcp .
docker run -p 8000:8000 \
  -e READWISE_TOKEN=your_token \
  readwise-mcp

项目结构

readwise-mcp-server/
├── main.py              # FastMCP服务器（12个工具，带有增强的MCP搜索）
├── readwise_client.py   # Readwise API客户端（支持MCP端点）
├── requirements.txt     # Python依赖
├── Dockerfile          # 容器配置
├── render.yaml         # Render部署
└── test_all_tools.py   # 测试套件

🤝 贡献

欢迎贡献！请：

1. 分叉仓库
2. 创建一个功能分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

🙏 致谢

使用以下构建：

• [FastMCP](https://github.com/jlowin/fastm mcp) - Python MCP框架
• Readwise API - Readwise平台
• MCP协议 - Anthropic的协议

⭐ 支持

如果您觉得这很有用，请给仓库点赞！

---

由❤️为Readwise和Claude AI社区制作