Cursor Readwise 插件 1.0.0 接入指南通过官方远程 MCP 服务器与 OAuth 打通你的阅读库【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins本篇技术指南以third_party/readwise插件及其 1.0.0 版本的发布说明CHANGELOG.md为核心讲解如何让 Cursor 中的 Agent 通过 Readwise 官方远程 Model Context ProtocolMCP服务器搜索高亮笔记与 Reader 文档、新建/更新/删除高亮、拉取每日回顾并保存、打标签、分类新素材。读完本文你将掌握该插件的 MCP 配置方法、OAuth 免密钥认证模型、Agent 可用能力清单以及连接成功后的验证技巧与常见陷阱。一、1.0.0 发布要点一次零配置的官方 MCP 集成third_party/readwise插件在 1.0.0 初始版本中对外交付了三项核心事实注册了名为readwise的 MCP 服务器指向官方远程端点https://mcp2.readwise.io/mcp认证采用OAuth流程无需配置 API Key 或 Client ID插件 Logo 使用 Readwise 官方标识来源于readwiseioGitHub 组织。这段发布说明揭示的设计取向是插件本身不做本地代理、不存凭证只负责在 Cursor 与 Readwise 官方托管的 MCP 服务之间建立一条标准连接。对应的实际配置就落在插件的 mcp.json 中{ mcpServers: { readwise: { type: http, url: https://mcp2.readwise.io/mcp } } }从 Cursor 插件清单结构看见仓库根目录 README.md 的 Repository structure 一节mcp.json正是插件目录中的标准 MCP 服务器定义文件而在插件清单规范 plugin.schema.json 中mcpServers字段被定义为路径、内联配置对象或两者数组本插件采用的是内联对象形式。二、MCP 服务器配置详解type: http与端点选择2.1 配置字段说明上述 JSON 中两个字段的含义如下字段值说明typehttp指定使用 HTTP 传输的远程 MCP 服务器区别于本地stdio子进程方式urlhttps://mcp2.readwise.io/mcpReadwise 官方托管 MCP 端点即工具调用实际发往的地址2.2 主机名陷阱是mcp2而非mcp插件 READMEthird_party/readwise/README.md明确提示正确主机名是mcp2.readwise.io而不是mcp.readwise.io。如果你在排查连接问题时怀疑是端点拼写错误优先核对这一处差异——这是该集成最常见的踩坑点之一。2.3 为什么无需 API Key1.0.0 发布说明与 README 都强调认证完全走 OAuthCursor 在插件连接时会弹出 Readwise 登录授权界面没有 API Key、没有 Client ID 需要配置。这意味着配置文件中不需要任何敏感字段mcp.json保持干净、可公开分发凭证生命周期由 OAuth 授权管理会话失效时由 Cursor 引导重新登录所有工具调用都以授权该连接的 Readwise 用户身份执行README Notes 第一条。三、安装方式有两种途径安装该插件打开Cursor Settings → Plugins搜索Readwise点击Install随后完成 Readwise 登录授权提示在聊天框中运行/add-plugin readwise。从市场注册表 .cursor-plugin/marketplace.json 可以看到该插件的市场条目name: readwise、source: third_party/readwise、描述为Search highlights and Reader documents, save articles.作者归属为 Cursor。四、Agent 能做什么能力矩阵插件 README 给出了官方的能力矩阵按功能域划分为四类分类能力Highlights高亮搜索与列出高亮、新建高亮、更新或删除已有高亮Daily review每日回顾拉取当前的每日回顾内容Reader documentsReader 文档搜索、列出、读取文档获取文档详情与其高亮Triage分诊/整理保存新文档、在位置间移动文档、添加或移除标签README 同时说明托管运行时才是工具名称与 Schema 的权威来源The hosted runtime is the source of truth for tool names and schemas。也就是说具体的工具函数签名以mcp2.readwise.io实际暴露的为准插件本地并不维护一份会过期的工具清单——这正是远程 MCP 架构的优势服务端更新工具时客户端无需升级插件。五、连接后的验证把readwise_get_daily_review当作冒烟测试README 给出一条非常实用的验收建议连接完成后调用readwise_get_daily_review作为只读冒烟测试read-only smoke test。理由很直接它是只读操作不会改动你的数据它覆盖了建立连接 → OAuth 授权有效 → 工具发现成功 → 服务端正常响应整条链路如果它能返回当日回顾说明 Agent 已具备操作其他高亮/文档工具的前提。验证通过后即可让 Agent 执行搜索高亮、整理阅读清单、为文章打标签等工作。六、注意事项与弃用警告身份边界所有工具调用都代表授权用户的 Readwise 账户执行因此涉及写入的操作新建高亮、保存文档、增删标签会真实作用于该用户的数据。端点版本使用mcp2.readwise.io/mcp作为服务器地址不要使用mcp.readwise.io。旧方案弃用readwise/readwise-mcpnpm 包是 Readwise 自家较旧的本地服务器实现已弃用、不支持 Reader新环境不应使用它。本插件的远程托管方案是其替代路径。七、仓库中的工程佐证插件如何被校验与分发third_party/readwise的接入方式并非孤立存在可以从仓库工程层面交叉验证市场注册入口 .cursor-plugin/marketplace.json 中readwise条目以source: third_party/readwise声明插件目录与仓库根 README.md 插件表格中的readwise行归类 Integrations一致。清单约束插件清单规范 plugin.schema.json 定义了mcpServers字段的合法形态字符串/对象/数组本插件的mcp.json即符合内联配置对象这一形态。校验脚本仓库提供 scripts/validate-plugins.mjs会遍历市场清单中每个插件目录校验.cursor-plugin/plugin.json是否符合 plugin.schema.json并核对市场条目name与插件清单name一致——这意味着像 Readwise 这样的第三方插件在合入市场前会经历相同的自动化校验流程保证分发的一致性。八、小结Readwise 插件 1.0.0 的核心理念可以概括为用最少的本地配置仅一个 HTTP 端点换取完整的官方能力接入。OAuth 免密钥模型省去了凭证管理远程托管服务器让工具集始终与服务端保持一致而readwise_get_daily_review冒烟测试则为每次连接提供了低成本的可验证性。对希望让 Cursor Agent 直接操作自己阅读资产的开发者而言这是当前仓库中一条开箱即用、路径清晰的集成方案。【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考