在 Cursor 中通过官方远程 MCP 服务器接入 Readwise混合语义搜索、高亮管理与阅读材料分流实战【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins本篇指南围绕third_party/readwise插件展开它通过 Readwise 官方远程 Model Context ProtocolMCP服务器将 Cursor Agent 与你的 Readwise 阅读资产连接起来既能对 Readwise 高亮与 Reader 文档执行混合语义 全文检索也能新建、更新、删除高亮保存新文章并打标签分流。读完本文你将掌握该插件的安装方式、mcp.json配置细节、OAuth 认证机制、Agent 可用能力清单以及连接成功后的冒烟测试方法。插件定位与工作原理Readwise 插件是 Cursor 官方插件市场.cursor-plugin/marketplace.json中的一员在 根 README 中的描述是“Search highlights and Reader documents, save articles”分类为Integrations。它属于远程 MCP 服务器型插件插件本身不内置任何本地工具代码而是把 Cursor Agent 指向 Readwise 官方托管的 MCP 端点https://mcp2.readwise.io/mcp由远端运行时动态暴露工具名称与参数 Schema。从仓库结构看插件目录 third_party/readwise 只包含四个文件README.md—— 使用说明与能力文档mcp.json—— MCP 服务器定义实际配置的唯一载体CHANGELOG.md—— 版本记录v1.0.0 初始发布LICENSE—— MIT 协议assets/logo.png—— Readwise 官方标识。这种“零本地逻辑、纯远程接入”的设计意味着工具的最终形态名称、参数、返回值由 Readwise 托管运行时决定插件侧只负责建立可信的连接与授权。安装步骤安装方式与其他 Cursor 插件一致有两种入口方式一图形界面打开Cursor Settings → PluginsCursor 设置 → 插件搜索Readwise点击Install安装随后在弹出的 Readwise 登录提示中完成授权。方式二聊天命令在 Cursor 对话中直接运行/add-plugin readwise安装完成后首次连接 MCP 服务器时 Cursor 会引导完成 Readwise 的 OAuth 登录流程。MCP 配置解析插件在 mcp.json 中声明的服务器配置如下{ mcpServers: { readwise: { type: http, url: https://mcp2.readwise.io/mcp } } }对照仓库中的 plugin.schema.jsonmcpServers字段支持字符串路径、内联对象或二者的数组此处采用的是内联对象形式。关键字段含义字段值说明mcpServers对象顶层 MCP 服务器映射键为服务器名称readwise对象本插件注册的服务器名Agent 以readwise前缀调用其工具typehttp使用 HTTP/Streamable HTTP 传输方式连接远程 MCP 端点urlhttps://mcp2.readwise.io/mcpReadwise 官方托管服务器地址注意这里的type: http与本地stdio型 MCP 服务器例如仓库中通过npx启动的本地进程型配置不同它直接面向公网端点因此不需要本地进程管理、不需要安装 npm 包。作为对比仓库中其他集成插件的mcp.json展示了配置的多样性GitHub 使用 Bearer Token 请求头注入个人访问令牌Salesforce 使用环境变量与 OAuth 客户端配置而 Readwise 走纯 OAuth无需任何密钥配置。认证机制OAuth零 API Key该插件认证完全依赖OAuth 流程当 Cursor 连接插件时会弹出 Readwise 登录/授权页面授权后工具调用以完成授权的那个 Readwise 用户身份执行不需要配置任何 API Key、Client ID 或环境变量CHANGELOG 中明确记录了这一点。Agent 能力全景连接成功后Agent 围绕你的阅读数据拥有四类能力类别能力高亮Highlights搜索和列出高亮新建高亮更新或删除已有高亮每日回顾Daily review拉取当前每日回顾内容Reader 文档Reader documents搜索、列出、阅读文档获取文档详情及其高亮分流Triage保存新文档在位置之间移动文档添加或移除标签配合文档开篇对检索能力的描述这意味着搜索并非简单的关键词匹配而是混合语义搜索 全文搜索hybrid semantic and full-text search覆盖 Readwise 高亮与 Reader 文档两大数据源。典型用法包括“找出我过去三个月里所有关于 RAG 架构的高亮”“把这篇新文章存进 Reader并打上research标签”“今天的每日回顾里有哪些内容需要处理”“帮我更新某条高亮的标签或删除一条过时的记录”。连接冒烟测试文档给出的唯一可确认工具名是readwise_get_daily_review。连接后建议先调用它作为只读冒烟测试调用 readwise_get_daily_review如果返回你账号的每日回顾数据说明 OAuth 授权成功、端点可达、工具 Schema 同步正常可以放心开展后续读写操作。之所以推荐用它而不是高亮写入类工具是因为它只读、无副作用是验证连接安全性的最低风险手段。注意事项与坑位提醒工具以授权用户身份运行所有工具调用都以完成 OAuth 授权的 Readwise 用户身份执行因此请确保登录的是你想要操作数据的账号。主机地址是mcp2.readwise.io不是mcp.readwise.io配置时务必核对域名两者并不等价。勿使用旧的本地 npm 包readwise/readwise-mcp是 Readwise 早期的本地服务器 npm 包现已废弃deprecated不支持 Reader 文档新环境不应再使用它。本插件采用的官方远程端点才是当前受支持的接入方式。工具 Schema 以托管运行时为准因为工具由远端动态暴露建议 Agent 在首次使用时通过 MCP 工具列表发现实际可用的工具名与参数而非硬编码假设。仓库依据与进一步阅读插件声明与市场注册.cursor-plugin/marketplace.jsonreadwise条目source 指向third_party/readwise插件自身文档third_party/readwise/README.md实际生效的 MCP 配置third_party/readwise/mcp.json配置 Schema 说明schemas/plugin.schema.jsonmcpServers字段定义版本记录third_party/readwise/CHANGELOG.md插件验证脚本scripts/validate-plugins.mjs批量校验各插件清单与 Schema 合法性许可证插件以 MIT 协议开源详见 third_party/readwise/LICENSE。Logo 使用 Readwise 官方标识源自readwiseioGitHub 组织。【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考