ReadAny CLI+MCP完全指南：让外部AI安全访问书库，受控工具而非裸数据

ReadAny CLIMCP完全指南让外部AI安全访问书库受控工具而非裸数据【免费下载链接】ReadAnyAI-powered cross-platform e-book reader with semantic search, RAG chat, local vector store, notes, TTS, and WebDAV sync.项目地址: https://gitcode.com/gh_mirrors/re/ReadAnyReadAny 是一款跨平台 AI 电子书阅读器而 ReadAny CLI 是它的本地能力网关——通过 MCP模型上下文协议把书籍、章节、笔记、高亮和 RAG 检索安全地开放给外部 AI如 Claude、Cursor、Codex。它开放的是一个个受控工具而不是裸数据库、任意文件系统或任意 shell这正是它与直接给 AI 一个数据库文件的本质区别。本指南带你快速完成安装、接入与权限管理。为什么是受控工具而不是裸数据把数据库直接交给 AI等于把整座图书馆的门钥匙都给了它能读、能删、还能顺手把书房的墙拆了。ReadAny 的设计原则只有一句话开放能力不开放裸数据库、任意文件系统、任意 shell。它的完整链路是这样的安装 CLI - 安装 Skill - 外部 AI 通过 MCP 发现 ReadAny - 读取书库 / 章节 / 当前上下文 / 笔记 / 高亮 / RAG - 创建 EPUB draft - AI 修改章节 / 元数据 / 目录 - 用户在 draft 工作区继续编辑 - 查看 history / diff - validate - export 新 EPUB - audit 全程可追踪每一层都有明确边界AI 做什么都绕不开这套流程。快速上手三步接入外部 AI第 1 步安装 CLI 并诊断最简单的方式是用桌面客户端打开设置 → 外部 AI 访问页面可以直接安装、修复 CLI无需自己拼命令。也可以手动执行readany install readany doctor --jsondoctor会输出机器可读的诊断信息Node 运行时、SQLite 原生模块、CLI 分发形态、工具数量、MCP 默认启动参数等。第 2 步一条命令完成 Agent 引导这是给外部 AI 准备的统一 bootstrap 命令适合直接复制给你的大模型执行readany agent setup --user --client all --profile readonly --json它会按安全顺序校验 profile/client → 安装或修复readany命令 → 安装$AGENT_HOME/skills/readany/SKILL.md使用手册 → 把 skill 链接到 Codex / Claude / Cursor / OpenCode 的对应目录 → 返回 MCP 配置片段。注意它不会静默修改任何外部客户端的配置MCP 片段需要由你显式放入。第 3 步复制 MCP 配置到 AI 客户端readany mcp config --profile readonly --client generic --json核心配置就长这样可直接粘贴进支持 MCP 的客户端{ mcpServers: { readany: { command: readany, args: [mcp, serve, --profile, readonly] } } }不同客户端的格式也不同CLI 都替你生成好了claude/cursor复用 JSONmcpServers片段codex输出config.toml的 TOML 片段opencode输出opencode.json的mcp.readany片段。权限 Profiles只读优先写入必须确认ReadAny 把权限分成五级默认永远是readonly。更高权限必须显式选择并确认风险后才可复制配置Profile能力范围典型用途readonly默认读书籍、内容、笔记、知识库RAG 搜索让 AI 查书、答疑assistantreadonly 写笔记、写知识库AI 帮你记笔记editorassistant EPUB 检视、创建/修改 draft、改元数据AI 精排电子书publishereditor 导出新 EPUB产出可发布的文件adminpublisher 导入、同步、备份高级管理场景Profile 到具体 scope 的映射在 packages/cli/src/profiles.ts 中定义每个权限位如book.read、epub.export都是独立声明的。记住设置页强调的三句话安装 CLI不等于授权外部 AI安装 Skill不等于开放写权限开启 MCP readonly 只允许读取和搜索。受控工具清单AI 到底能做什么MCPtools/list只暴露真实实现、测试通过的工具按资源域命名共 26 个主要分四类 只读数据books.list、books.search、books.get、chapters.list、chapters.get、context.get当前书/章/选区快照、bookmarks.list、skills.list 搜索notes.search、highlights.search、knowledge.search聚合书籍/笔记/高亮、rag.searchBM25 / hybrid / vector 三模式向量未配置时安全回退到 BM25✏️ EPUB 精排editor 权限epub.inspect、epub.draft.create、epub.chapter.read/patch、epub.chapters.patch1-50 章批量计划、epub.metadata.patch、epub.toc.rebuild、epub.history、epub.diff、epub.undo、epub.draft.discard 导出publisher 权限epub.validate、epub.export、notes.export、knowledge.export而shell.exec、sql.query、任意文件读写这类危险工具不设计、不实现。CLI 与 MCP 使用统一的结构化结果成功/错误码 数据大结果自动分页限流。安全边界5 道防线原书永不修改所有 EPUB 修改都发生在 draft 工作区原始文件的 hash 保持不变导出也只生成新文件默认不覆盖draft-first写入链路必须先生成计划 → 应用到 draft → 用户确认导出用户和 AI 共用同一套 history / diffAI 的每笔修改都能追溯、可undo参数严格校验每个工具的 inputSchema 都有required和additionalProperties: false未声明的参数、超范围的值会被运行时直接拒绝审计只记元数据写操作、导出、同步都会记录来源、profile、工具名和摘要但绝不记录完整正文、API key、同步密码工具清单诚实规划中的工具只写在设计文档未真实接线前不会出现在tools/list里避免让 AI 知道能力存在式的虚假承诺。桌面客户端图形化一站式管理桌面端的设置 → 外部 AI 访问页面是普通用户的主入口四块状态卡片一目了然ReadAny CLI安装 / 卸载 / 修复 / 诊断External AI Skill安装、更新、卸载到通用 agent 目录MCP Access按客户端复制配置、测试连接、切换 profileActivity Log最近的 agent 调用、权限拒绝、导出记录。页面支持按来源、失败、时间等条件筛选审计记录。注意用户精排入口不在设置页——章节编辑、diff 查看、撤销都在书籍详情页的draft 工作区里完成设置页只负责接入和权限管理。关键文件索引CLI 设计总览docs/readany-cli/00-overview-and-acceptance.md命令与工具规范docs/readany-cli/05-command-and-tool-spec.md架构与安全模型docs/readany-cli/02-architecture-security.md桌面设置页设计docs/readany-cli/06-client-settings.mdCLI 源码packages/cli/src/其中 MCP 服务在 packages/cli/src/mcp.ts、工具注册表在 packages/cli/src/tool-registry.ts、权限模型在 packages/cli/src/profiles.ts常见问题Qreadonly 模式下 AI 能写吗不能。任何写入或导出工具在 readonly 下都会收到permission_denied错误码这也是每个里程碑验收的必查项。Q安装 Skill 后会暴露我的同步凭证吗不会。Skill 只是一个使用说明文件不存数据、不持密钥输出内容也不包含密钥、同步配置或本地绝对路径。QAI 改坏了书怎么办它碰不到原书。所有修改都在 draft 里你可以随时看 diff、undo单步、或整个 discard导出前还会先 validate确认结构无误才生成新 EPUB。Q手机能用吗CLI / MCP 的主入口在桌面端。移动端定位为轻量查看不承担 CLI 安装和 MCP 注册。写在最后ReadAny CLI 把给 AI 开权限这件事做成了可分级、可审计、可回滚的工程化能力先 readonly 让 AI 帮你查书答疑确认靠谱后再按需开启 editor / publisher 精排导出。如果你希望外部 AI 真正读得懂你的书又不越界这套受控工具链值得一试。【免费下载链接】ReadAnyAI-powered cross-platform e-book reader with semantic search, RAG chat, local vector store, notes, TTS, and WebDAV sync.项目地址: https://gitcode.com/gh_mirrors/re/ReadAny创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考