关于 Drop2Run
Drop2Run 提供发布服务、命令行工具和 MCP 服务,适合需要将生成的页面、文档或网站转换为 HTTPS 链接的 Agent。其 MCP 工具还可管理站点、共享和评论。
主要功能
- 01发布文件或本地目录
- 02管理站点和部署版本
- 03邀请及管理协作者
- 04查看和处理评论
- 05返回结构化发布结果
适用场景
- 01将 Agent 生成的页面发布为在线链接
- 02通过命令行部署构建好的网站目录
- 03回滚或暂停已发布的站点
MCP 相关
MCP 服务提供 20 个工具,用于发布文本文件以及管理站点、共享、评论和登录。可通过本地包或 https://mcp.dropto.run/mcp 上的托管服务接入。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.dropto.run/mcpclaude mcp add --transport http run-dropto-drop2run https://mcp.dropto.run/mcp{"mcpServers":{"run-dropto-drop2run":{"type":"http","url":"https://mcp.dropto.run/mcp"}}}在 Cursor 中打开{"servers":{"run-dropto-drop2run":{"type":"http","url":"https://mcp.dropto.run/mcp"}}}在 VS Code 中打开{"mcpServers":{"run-dropto-drop2run":{"type":"http","url":"https://mcp.dropto.run/mcp"}}}{"mcpServers":{"run-dropto-drop2run":{"serverUrl":"https://mcp.dropto.run/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
19| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| replace | boolean | 否 | 即使已存储令牌,也要登录。切换账户或存储的令牌被拒绝时使用。 |
| waitSeconds | integer | 否 | 此调用等待批准的时长。默认值为 120。 |
详细介绍
drop2run-cli
这是两个 Drop2Run 本地运行软件包的源码:drop2run
命令行工具和 @drop2run/mcp 服务。
两者都会全局安装,然后交由凭据使用。此代码库的存在,是为了让你了解凭据将被交给什么。
npm i -g drop2run # https://www.npmjs.com/package/drop2run
npx @drop2run/mcp # https://www.npmjs.com/package/@drop2run/mcp
使用方法
命令行工具通过浏览器登录并发布文件夹:
drop2run login
drop2run deploy dist
login 需要在同一台机器上使用浏览器;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 只需一条命令:
claude mcp add drop2run -s user -- npx -y @drop2run/mcp
无法运行软件包的聊天客户端——例如网页版 Claude、手机上的 Claude 和 ChatGPT——可以改为通过 URL 添加同一服务的托管版本:https://mcp.dropto.run/mcp,并在连接时登录 Drop2Run。在
Claude 中,它也列在连接器目录中。它的
工具来自此处的 packages/mcp(src/remote.ts);前置的登录流程则不在其中。
它只能发布文本文件,设置说明见 dropto.run/docs/mcp。
它提供二十个工具,分为五组:
| 分组 | 工具 |
|---|---|
| 发布 | publish_files、publish_dir — 第二个工具会读取磁盘上的文件夹,因此仅限本地使用 |
| 站点 | list_sites、list_folders、get_site、update_site、pause_site、resume_site、rollback_site、change_subdomain、delete_site |
| 共享 | list_people、invite_people、remove_person |
| 评论 | list_comments、reply_comment、resolve_comment、reopen_comment |
| 登录 | login、login_code — 仅限本地服务;托管版本会在连接时登录 |
发布结果会在句子旁附带结构化字段,因此无需从散文中提取 URL。delete_site 和
change_subdomain 会要求你重复输入站点当前的子域名后才会运行;pause_site 是让站点暂时下线的可逆方式。令牌会存放在 CLI 存储令牌的同一位置,因此通过任一方式登录即可同时用于两者。
每个软件包都提供了完整文档,包括登录流程以及未提供 site 时会发生什么:packages/cli/README.md 和
packages/mcp/README.md。托管版文档位于
dropto.run/docs/cli 和
dropto.run/docs/mcp。
内容一览
| 软件包 | 已发布 | 说明 |
|---|---|---|
packages/cli | drop2run | 命令行工具:login、deploy、ls、rollback、rm |
packages/mcp | @drop2run/mcp | MCP 服务,让 Agent 可以发布刚刚编写的内容 |
packages/core | 无 | 部署引擎——清单、哈希、上传、上线。不使用 Node API 或浏览器 API |
packages/node | 无 | 需要 fs 的部分:读取文件夹、配置文件和令牌存储 |
core 和 node 不会发布。它们会在构建时打包到每个软件包的 dist/ 中,因此 drop2run 安装后完全没有运行时依赖——这是针对持有令牌的软件包而做出的有意选择。@drop2run/mcp 有两个依赖,都是协议所必需的:@modelcontextprotocol/sdk 和 zod。
构建与测试
每个软件包都可以独立运行——没有工作区根目录,内部导入通过各自 tsconfig.json 中的相对 paths 解析。
cd packages/cli # or mcp, or node
npm ci
npm run typecheck
npm test
npm run build # writes dist/, which is what npm ships
packages/core 没有依赖,也没有自己的构建流程;它由打包它的软件包进行类型检查。
其余内容在哪里
本仓库是上述四个软件包的导出版本,包含它们的完整历史记录。Drop2Run 服务本身——API、边缘路由器和控制面板——不在此仓库中,也不开源。实际而言,这意味着本仓库无法让你审查文件离开你的设备后会发生什么。它能让你审查的是在此之前对你的文件和令牌所做的一切,而这些代码运行时使用的是你的权限。
欢迎在此提交有关 CLI 或 MCP 服务的问题。托管服务相关的事宜请联系 dropto.run/contact。
也欢迎提交拉取请求,但有一点值得提前了解:本仓库由自动流程生成,因此拉取请求不会在此处合并。更改会应用到源代码仓库,并在下一次导出时同步到此仓库,同时保留你的提交和作者信息;随后,拉取请求会附上提交链接并关闭。如果改为在此处合并,就会在此仓库的历史记录中留下一个后续导出中不存在的提交,两边会在下一次更新时立即分歧。
许可证
MIT。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。