STARWARCLOUD STARWAR.AI
返回市场
远程读取智能-MCP

远程读取智能-MCP

作者：mayankbohra5 星标更新：2025-11-12
安装使用来源：spider==github.com

项目介绍

Readwise MCP Server 📚

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

Python 3.10+ FastMCP

✨ 您可以做什么？

设置完成后，您可以向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错误”

仍需帮助？

🔒 安全与隐私

  • ✅ 所有请求通过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. 提交拉取请求

🙏 致谢

使用以下构建：

⭐ 支持

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

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