用途
drop2run-cli 是 Drop2Run 两个本地运行包的源码仓库:drop2run 命令行工具与 @drop2run/mcp 服务器。两者都先全局安装,再交给它们一个凭据。仓库存在的目的,是让用户能阅读自己把凭据交给了什么代码。
它的核心用途是把静态站点或智能体的输出发布成一个 HTTPS 链接,不需要 git,也不需要构建配置。静态托管运行在 Cloudflare 的边缘网络上。
主要能力
命令行工具通过浏览器登录并发布一个文件夹。登录需要同一台机器上有浏览器;drop2run login --device 覆盖远程 shell 场景,CI 则使用来自 https://app.dropto.run/account/tokens 的 DROP2RUN_TOKEN。其他命令包括 init、ls、open、rollback、rm、token list、whoami 和 where,任意命令加 --json 都会输出机器可读的结果。
MCP 服务器通过客户端注册使用,而不是手动运行。Claude for macOS 和 Windows 从捆绑包安装——下载 drop2run.mcpb 并打开即可,没有配置文件,也无需先安装任何东西。Claude Code 只需一条命令即可接入。
它暴露的工具包括:publish_files、publish_dir、list_sites、list_folders、delete_site、get_site、update_site、pause_site、resume_site 和 rollback_site,以及用于在聊天中直接获取 token 的 login / login_code。发布操作的返回结果在句子之外还有结构化字段,因此 URL 不必从自然语言里读回来;delete_site 是永久性的,运行前会要求重复输入站点的子域名进行确认。token 存放在与 CLI 相同的位置,因此通过任意一个登录都会同时覆盖两者。
每个包都有完整文档,包括登录流程以及没有站点时会发生什么:packages/cli/README.md 和 packages/mcp/README.md。托管文档位于 dropto.run/docs/cli 和 dropto.run/docs/mcp。
使用方式
仓库内包含 CLI 与 MCP 两个包,core 和 node 不对外发布,它们会在构建时被捆绑进各包的 dist/ 中,因此 drop2run 安装后完全不依赖任何运行时依赖——这是持有 token 的工具的有意选择。@drop2run/mcp 有两个协议要求的依赖:@modelcontextprotocol/sdk 和 zod。
适用场景
适合需要把静态站点或 AI 智能体输出快速发布为 HTTPS 链接的用户,尤其是希望跳过 git 和构建配置、且需要从聊天或本地文件夹直接发布的工作流。
限制
Drop2Run 服务本身——API、边缘路由器、仪表盘——不在本仓库中,也不是开源的。这意味着文件离开本机之后发生什么,无法通过本仓库审计;可以审计的是文件与 token 到达该点之前的所有处理,也就是以用户权限运行的部分。关于 CLI 或 MCP 服务器的问题欢迎在此提出,托管服务相关的问题应前往 dropto.run/contact。本仓库是生成式的,因此 pull request 不会在此合并,变更会在源仓库应用后于下一次导出时进入本仓库,并保留提交与作者信息。