OtaKit MCP Server

官方

为 Capacitor 应用推送 OTA 更新，无需应用商店审核

分类: 开发工具第 158 / 438
Stars: ★ 46 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20.9+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 12 天前

57FMRS · C

OtaKit 是由上游项目官方维护的开源 Capacitor OTA 更新框架，其 MCP 服务器让编码代理能够检查、上传、发布、监控和回滚更新，并在发布到设备前请求人工批准。适合使用 Capacitor 并希望绕开应用商店审核发布 Web 资源更新的团队；不适用于非 Capacitor 项目或需要修改原生代码的场景。使用时需注意授予的账号权限、上传与发布操作对线上渠道的影响，以及自托管带来的运维成本。

最强项 · 安装易用性 13/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

10/20

维护活跃度

13/20

文档质量

11/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: server.json 声明的包 @otakit/[email protected] 以 stdio 传输并提供 `mcp` 位置参数，同时声明 streamable-http 远程端点，两条路径在自述文档中均有对应说明（`npx -y @otakit/cli@latest connect` 与 remote OAuth），启动路径在文字上自洽。但本次为纯静态审阅：仓库中没有任何已提交的测试文件、CI 工作流或可复现的执行记录被提供，无法验证 MCP 初始化与工具清单握手是否成功，也无法验证声明的 inspect/upload/release/monitor/revert 工具与真实行为一致。文档承认上传/发布流程依赖 Postgres、S3 兼容存储与 CDN，自建时依赖较复杂且失败面（网络、对象存储、CDN 缓存）未提供诊断说明。按静态校准上限 12 分，考虑缺少测试与执行证据，扣分至 10。
安全与权限 10/20: 未触发红线：未发现恶意代码、凭据窃取、隐蔽外传、伪造维护者身份或安装示例中硬编码的真实令牌；MIT 许可且自称完全开源、可自建。但权限与确认机制证据不足：文档仅描述‘在你批准之前不会触达设备’，属产品层描述而非可审阅的服务端确认逻辑；CLI 登录会写入配置文件（文档提到会打印将写入的确切文件），但凭据如何存储、是否落到明文配置、作用域如何最小化均未说明；远程端点 https://console.otakit.app/mcp 涉及外部网络与 OAuth，数据流（哪些项目元数据、bundle 上传到何处）披露不完整；upload/release/revert 属不可逆或高危副作用操作，缺少默认二次确认与权限分层（如 channel 级别的 scoping）的静态证据。按‘主要风险可见但权限/确认/作用域不完整’给 10。
维护活跃度 13/20: 仓库信息显示未归档、0 个开放 issue、86 星、MIT 许可，版本 1.5.0 与包版本一致，自述中列出清晰的 monorepo 包划分（capacitor-plugin、cli、mcp-core、console、ingest、site、tinybird），说明项目结构健康、有持续发布痕迹（版本号已达 1.5.0）。但缺少关键治理证据：无可见的发布日志/CHANGELOG、无 CI 工作流、无安全响应渠道或披露政策说明、无 commit 频率与 issue 响应数据（0 issue 也可能意味着无社区反馈）。许可证明确是加分项，版本化路径在 manifest 中有体现。按‘活跃但治理/版本化有缺口’给 13。
文档质量 11/20: 文档分层较好：顶层 README 覆盖自建架构（console + Postgres + S3 兼容存储 + CDN）、工作原理七步流程、核心概念（App/Bundle/Release/Channel/runtime version）、包结构图、各包 README 指引、本地开发前置条件（Node 20.9+、pnpm 9+、.env.example），并指向 agents 指南与自建指南。但存在实质缺口：MCP 工具的具体参数、返回结构、权限与作用域、速率/配额限制、计费与成本说明均未在提供材料中给出；错误处理与排障章节缺失；`connect` 命令的交互细节只在文中概述，没有可复核的示例输出或客户端配置样例。文档与能力无直接矛盾，按‘可用但存在隐藏假设与排障缺口’给 11。
安装易用性 13/20: 安装路径相对清晰且步骤少：标准 npm 生态，`npx -y @otakit/cli@latest connect` 一条命令即完成客户端探测、登录与配置写入，并强调会先打印 console/organization/project/app 与目标文件、支持 `--dry-run`，对主流客户端（Claude Code、Codex、VS Code）有明确指引，Claude Code 还提供 plugin marketplace 安装方式。扣分项：stdio 方式需要 Node.js 20.9+ 运行时；self-host 路径依赖 Postgres 与 S3 兼容存储及 CDN，属较重的手动配置；远程 streamable-http 端点的 OAuth 配置细节被外链到文档而未在提供材料中给出，无法静态验证。按静态校准上限 15 分，考虑到材料中无客户端配置文件样例与可复现执行证据，给 13。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络修改第三方账户数据

适合谁

使用 Capacitor 构建 Android/iOS 应用并希望绕过应用商店审核发布 Web 资源更新的团队
使用 Claude Code、Codex 或 VS Code 并希望由代理协助发布 OTA 更新的开发者
需要自托管 OTA 更新平台的组织

不适合谁

非 Capacitor 项目或未使用 OtaKit 的应用
需要修改原生代码而非 Web 资源的更新场景
不愿授予代理上传与发布权限的团队

所需权限

需要 OtaKit 账号登录（npx @otakit/cli login），以获得访问控制台、组织和项目的权限
CLI 会写入客户端配置文件（connect 会打印将要写入的确切文件）
上传构建产物并创建发布需要对应项目的写入权限
远程连接 https://console.otakit.app/mcp 时涉及 OAuth 授权

风险与副作用

在未审批的情况下发布，可能把有问题的构建推送到真实设备
上传与发布操作会修改线上渠道的清单，影响后续启动或恢复的应用
自托管部署需要自行维护 Postgres、兼容 S3 的存储桶、CDN，以及可选的 ingest 服务与 Tinybird 工作区
配置文件写入由 CLI 执行，需先核对 connect 打印的目标文件路径

安装接入

准备工作

运行环境：Node.js 20.9+ · 远程托管（无需本地环境）

在项目目录下运行一条命令：npx -y @otakit/cli@latest connect。它会检测你的客户端、在需要时登录，并在写入任何内容之前打印解析出的控制台、组织、项目和应用信息，以及将要写入的确切文件。使用 --dry-run 可以只查看计划而不写入。Claude Code 另有插件可同时提供服务器与 OtaKit Agent Skill：先运行 npx -y @otakit/cli@latest login，再运行 claude plugin marketplace add OtaKit/otakit 和 claude plugin install otakit@otakit。

验证是否装好

在项目目录运行 npx -y @otakit/cli@latest connect --dry-run，它会打印解析到的 console、organization、project、app 以及将要写入的文件且不做任何修改；连接成功后客户端工具列表中应出现 OtaKit 的工具。

常见排障

先运行带 --dry-run 的 connect，确认解析到的控制台、组织、项目与应用是否正确
确认已登录：运行 npx -y @otakit/cli@latest login
确认已在 capacitor.config.* 中填入正确的 appId
远程连接失败时检查 https://console.otakit.app/mcp 的 OAuth 授权是否完成
自托管环境下检查 Postgres 与兼容 S3 存储桶的配置，参考 packages/console/.env.example
若担心 OTA 更新兼容性，检查插件中配置的运行时版本（runtime version）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我检查我的 Capacitor 项目，判断这次改动是否适合通过 OTA 更新发布
把当前构建上传到 OtaKit 并发布一个 release
先做 dry-run 看看你会修改哪些文件
回滚到上一个 OTA 版本

使用场景

在编辑器或编码代理中检查、上传并发布 Capacitor 应用的 OTA 更新

发布前判断改动是否适合通过 OTA 下发

发布后监控更新状态并在需要时回滚

在发布到设备前设置人工审批环节

支持客户端

Claude Code

Codex

VS Code

依据项目文档列出，未经本站实测。

详细介绍

OtaKit 是一个完全开源、可自托管的 Capacitor 应用空中更新（OTA）框架，让开发者无需经过应用商店审核即可直接向 Capacitor 应用发布更新。其 MCP 服务器用于检查、上传、发布、监控和回滚 OtaKit 的 Capacitor OTA 更新。可从 npm 包 @otakit/cli 以 stdio 方式启动（通过 mcp 子命令），也可通过 https://console.otakit.app/mcp 使用 streamable-http 远程连接。当用户要求 Claude Code、Codex 或 VS Code 发布更新时，它可以读取 Capacitor 项目、判断改动是否适合通过 OTA 下发、上传构建产物，并在内容到达设备前停下来等待用户批准。