读取MCP服务器
](https://smithery.ai/server/@IAmAlexander/readwise-mcp)    ](https://www.npmjs.com/package/readwise-mcp)
A. 模型上下文协议（MCP） 服务器 睿读，允许AI助手访问您保存的文章、书籍、亮点和文档。
特性
- 书籍与文章：浏览您保存的书籍和文章集
- 亮点：访问所有突出显示的段落
- 搜索：在整个Readwise库中查找内容
- 最近的内容：快速检索最新保存的项目
- 标签管理：使用标签组织和过滤内容
- 高级搜索：按作者、日期、标签等进行强大过滤
- 阅读进度：跟踪您的阅读状态和完成百分比
- 批量操作：一次高效管理多个文档
- 内容管理：保存、更新和删除库中的内容
- 视频支持：访问并与Readwise阅读器中保存的视频进行交互
- 速率限制：智能处理API限制以防止节流
- 运输选项：支持stdio（Claude Desktop）和SSE（web）传输
- MCP合规性：完全符合协议，正确处理request_id
安装
通过Smithery安装
要通过Smithery自动安装Readwise MCP for Claude Desktop，请执行以下操作：
npx -y @smithery/cli install @iamalexander/readwise-mcp --client claude手动安装
- 获取Readwise API令牌:
- 登录到您的 Readwise帐户 - 首选 生成您的API令牌 - 复制令牌以供以后使用
- 从npm安装:
npm install -g readwise-mcp- 或者克隆并构建:
git clone https://github.com/IAmAlexander/readwise-mcp.git
cd readwise-mcp
npm install
npm run build- 配置API密钥:
# Run the setup wizard
npm run setup
# Or start with the API key directly
readwise-mcp --api-key YOUR_API_KEYDocker支持
如果你更喜欢使用Docker：
- 创建配置目录:
mkdir -p ~/.readwise-mcp- 构建并运行:
docker build -t readwise-mcp .
docker run -p 3001:3001 -e READWISE_API_KEY=your_key readwise-mcp使用示例
一旦连接到克劳德，就可以通过以下问题释放你的Readwise知识：
- “查找我关于‘共鸣优先编程’和美学IDE的亮点”
- “关于克劳德·科德的秘密复活节彩蛋，我保存了什么？”
- “显示所有标记为‘AI’和‘生产力’的文章”
- “我的阅读清单上有什么我还没有开始的？”
- “查找我在过去3个月内保存的Paul Graham的文章”
- “给我看看我读完的书”
- “将此文章保存到我的Readwise：https://example.com/interesting-article"
- “在关于量子计算的文章中添加标签‘必须阅读’”
- “我在那本关于机器学习的书上的阅读进展如何？”
视频相关示例
- “显示我在Readwise中保存的所有YouTube视频”
- “我在那段关于TypeScript的视频中做了哪些亮点？”
- “我当前播放AI会议视频的位置是什么？”
- “在我的库中查找提到‘机器学习’的视频”
- “在TypeScript教程的23:45创建一个突出显示，并注明‘重要模式’”
- “在人工智能安全视频的15分钟左右，演讲者说了什么？”
- “显示我昨天保存的编程教程的成绩单”
功能文档
基本特性
浏览内容
- 列出书籍和文章：使用分页检索您保存的书籍
- 获取亮点：使用筛选选项访问所有突出显示的段落
- 搜索内容：在整个库中进行全文搜索
- 获取最新内容：快速访问您最新保存的项目
标签管理
使用标签组织您的内容：
- 列出所有标签：获取库中的所有标签
- 获取文档的标签：查看特定文档上的标记
- 更新标签：替换文档上的所有标签
- 添加特定标签：向文档添加单个标记
- 删除特定标签：从文档中删除标记
- 批量标记：一次将标签应用于多个文档
高级搜索
强大的过滤选项，可准确找到您需要的内容：
query：搜索文本category：按内容类型（书籍、文章等）筛选tags：按标签筛选（逗号分隔）author：按作者筛选title：按标题筛选location：按位置筛选（新、稍后、存档、提要）dateFrom&dateTo：ISO 8601格式的日期范围sortBy：要排序的字段（created_at、updated_at、title、author）sortOrder：排序方向（asc、desc）
阅读进度跟踪
跟踪您的阅读状态和进度：
- 获取阅读进度：查看任何文档的当前进度
- 更新阅读进度：设置状态、百分比和页码
- 获取阅读列表：按读取状态筛选
读取状态：
not_started：还没开始读in_progress：目前正在阅读completed：已完成阅读
视频特征
访问并与Readwise阅读器中保存的视频进行交互：
视频列表和详细信息
- 列出所有视频：从YouTube、Vimeo和其他平台浏览视频
- 通过成绩单获取视频详细信息：访问完整的元数据和时间同步的成绩单
精选影片
- 使用时间戳创建突出显示：在视频中标记重要时刻
- 获取视频亮点：检索视频的所有亮点，按时间戳排序
视频播放位置
- 更新播放位置：保存您当前的职位，以便稍后恢复
- 获取播放位置：从你中断的地方继续
成绩单访问的工作原理
视频转录功能：
- 从视频的HTML内容中提取时间同步的成绩单
- 解析时间戳和文本对
- 以带时间戳的段数组形式返回转录
这使您能够：
- 在视频中搜索特定内容
- 在精确的时刻创造亮点
- 直接跳到重要点
- 参考具有精确时间背景的视频内容
内容管理
保存、更新和删除内容：
- 保存新内容：将URL、文章或自定义内容添加到库中
- 更新文档：修改标题、作者、摘要、标签等
- 删除文档：删除内容（有安全确认）
批量操作
一次高效管理多个文档：
- 批量保存：保存多个URL/内容项
- 批量更新：更新多个文档
- 批量删除：删除多个文档
- 散装标签：将标签应用于多个文档
安全确认
所有批量操作和删除都需要明确确认，以防止意外数据丢失：
- 单文档删除：需要确认参数
- 批量操作：需要特定的确认字符串
这些确认起到了“人在环”安全机制的作用。
API状态
随时查看API状态和费率限制信息。
可用工具
服务器提供30个工具用于与Readwise库交互：
核心工具
- 获取高亮显示：通过过滤和分页检索亮点
- 获取_书籍：从图书馆借书
- get_文档：从图书馆获取文档
- 搜索_高亮显示：按查询搜索亮点
- 获取标签：列出库中的所有标签
- get_recent_content：获取最近保存的内容
标签管理
- 文档标签：获取、更新、添加或删除文档上的标记
- 散装标签：将标签应用于多个文档
阅读进度
- get_reading_progress：获取特定文档的进度
- update_reading_progress：更新阅读状态和进度
- get_reading_list：获取按阅读状态筛选的文档
亮点管理
- create_highlight：创建新的亮点
- update_highlight：修改现有突出显示
- 删除高亮显示：删除突出显示
- create_note：为突出显示添加注释
搜索工具
- 高级搜索：强大的多参数搜索
- search_by_tag：按标签查找内容
- 搜索_日期：按日期范围查找内容
视频工具
- 获取_视频：列出库中的视频
- 获取_视频：通过成绩单获取视频详细信息
- 创建_视频_高亮度：使用时间戳创建突出显示
- 获取_视频_高亮度：获取视频的所有精彩片段
- 更新_视频_位置：保存播放位置
- 获取_视频_位置：获取保存的播放位置
文档管理
- 保存_文档：将新内容保存到库
- update_document：修改文档元数据
- 删除文档：删除文档
批量操作
- bulk_save_文档：保存多个文档
- bulk_update_文档：更新多个文档
- bulk_delete_documents：删除多个文档
可用资源
MCP资源为LLM客户端提供直接数据访问：
- 书籍 (
readwise://books)：Readwise图书馆的书籍列表 - 近期亮点 (
readwise://highlights/recent)：您图书馆的最新亮点 - 标签 (
readwise://tags)：Readwise库中所有标签的列表
可用提示
- 阅读_高亮显示：Readwise的流程亮点
- 支持总结、分析、连接查找和问题生成 - 包括强大的错误处理和参数验证 - 格式以读者友好的方式突出显示
- readwise搜索：搜索并处理Readwise的亮点
- 提供带有源信息的格式化搜索结果 - 使用用户友好的消息优雅地处理API错误 - 包括对所需参数的验证
演示和测试
该存储库包含演示文件，可帮助您测试和探索功能：
许多的演示文件
- 演示/测试连接.html：测试与服务器的基本连接
- demo/mcp-demo.html：所有功能的全面用户界面
- demo/video-features.html：视频功能专用接口
- 演示/增强转录功能.html：高级转录功能
运行测试
# Run the full test suite
npm test
# Run automated inspector tests
npm run test-inspector
# Test without a real API key (mock mode)
npm run test-mockMCP检验员测试
# Test with stdio transport (default)
./scripts/inspector.sh
# Test with SSE transport
./scripts/inspector.sh -t sse -p 3001
# Enable debug mode
./scripts/inspector.sh -d整合
克劳德桌面版
添加到您的Claude Desktop配置中：
- Linux:
~/.config/Claude/claude_desktop_config.json - 苹果电脑:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"readwise": {
"command": "readwise-mcp",
"env": {
"READWISE_API_KEY": "your_api_key_here"
}
}
}
}光标
添加到 .cursor/mcp.json 在您的项目中：
{
"mcpServers": {
"readwise": {
"command": "readwise-mcp",
"env": {
"READWISE_API_KEY": "your_api_key_here"
}
}
}
}克劳德代码
通过CLI安装：
claude mcp add readwise-mcp --transport http https://server.smithery.ai/@IAmAlexander/readwise-mcp/mcp或者使用JSON配置格式：
{
"mcpServers": {
"readwise-mcp": {
"type": "http",
"url": "https://server.smithery.ai/@IAmAlexander/readwise-mcp/mcp"
}
}
}部署
史密瑟里
通过Smithery CLI安装：
npx @smithery/cli install @iamalexander/readwise-mcp --client claude或者在 Smithery登记处.
铁路（一键部署）
- 单击上面的按钮或转到 铁路
- 连接您的GitHub仓库
- 添加环境变量：
READWISE_API_KEY - 部署！
渲染
- 在上创建新的Web服务 渲染
- 连接您的GitHub仓库
- 渲染将自动检测
render.yaml - 添加环境变量：
READWISE_API_KEY - 部署！
码头工人
docker build -t readwise-mcp .
docker run -p 3001:3001 -e READWISE_API_KEY=your_key readwise-mcp故障排除
令牌问题
如果遇到身份验证问题：
- 验证您的Readwise API令牌在
- 通过删除存储的凭据重置身份验证：
rm ~/.readwise-mcp/credentials.json- 重新启动并尝试重新连接
连接问题
如果服务器无法连接：
- 确保服务器正在运行（如果手动启动）
- 检查端口3001是否未被其他应用程序使用
- 重新启动AI客户端（Claude Desktop、Cursor等）
速率限制
服务器包括内置的速率限制。如果遇到速率限制错误：
- 请等待几分钟，然后重试
- 减少请求的频率
- 检查响应中的速率限制标头
视频特定问题
- 缺少成绩单并非所有视频都有文字记录。YouTube视频通常有最好的支持。
- 成绩单质量：成绩单来自视频平台，可能包含错误。
- 时间戳不一致：不同的平台使用不同的格式；API在可能的情况下进行标准化。
- 播放位置未更新：确保两者
position和duration提供了参数。
隐私和安全
- 您的Readwise API令牌安全存储在本地计算机上
- 只有在明确请求时才能访问您的Readwise数据
- MCP服务器上没有永久存储数据
- 安全确认可防止意外数据丢失
发展
# Build the project
npm run build
# Run tests
npm test
# Start in development mode with auto-reload
npm run dev:watch
# Lint code
npm run lint项目结构
- src/：主源代码
- 测试脚本/：测试脚本和实用程序
- 示例/：示例实现
- demo/：交互式HTML演示
- 测试/：测试套件
贡献
发现bug了吗？对一个功能有想法吗？想让这个MCP服务器更棒吗？欢迎并鼓励捐款！
如何做出贡献
- 分叉此回购 （最好是在啜饮您选择的饮料时）
- 创建功能分支 (
git checkout -b feature/my-amazing-idea) - 编写一些优化振动的代码 （RGB注释可选，但值得赞赏）
- 提交您的更改 (
git commit -m 'Add mind-blowing feature') - 推到分支 (
git push origin feature/my-amazing-idea) - 打开拉取请求 并等待多巴胺融合后的作用
所有的贡献，无论大小，无论是实际的还是异想天开的，都受到重视！
许可证
MIT许可证
版权所有（c）2023亚历山大
特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：
上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。
软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。
