Nippy

@nippyhost/cli

从终端、CI 或 Claude 将网站发布到 nippy.host。放入一个文件夹，获取一个链接——照片会变成图库，文件会变成下载页面，网站则会正常运行。链接永不过期。

npx @nippyhost/cli login                       # one-time: approve in your browser, done
npx @nippyhost/cli deploy ./dist --site demo   # → https://demo.nippy.site

可执行文件名为 nippy，因此全局安装后即可使用这个简短命令：

npm i -g @nippyhost/cli
nippy deploy ./photos --site henderson-wedding

命令

命令	功能
nippy login	打开浏览器，在 nippy.host 上授权 CLI（OAuth，无需复制粘贴），并将生成的限定范围令牌存储在 ~/.config/nippy/（chmod 600）中。无头/SSH 机器可使用 --paste
nippy deploy [path] --site <name>	发布文件夹、单个文件或 zip。已有站点 → 原地更新，URL 不变；站点不存在 → 创建站点。--new 强制创建新站点，脚本可使用 --json
nippy sites / nippy sites info <name>	列出站点 / 显示某个站点的文件
nippy open <name>	打开 https://<name>.nippy.site
nippy whoami	查看当前使用的凭据，以及凭据是否有效
nippy mcp install [--client …]	将 MCP 服务添加到 Claude Desktop、Claude Code 或 Cursor
nippy mcp serve	在 stdio 上运行 MCP 服务（由助手调用）

在 Claude 中使用（MCP）

在 claude.ai（或任何支持远程 MCP 服务的客户端）上使用：无需安装。 添加自定义连接器，URL 为 https://api.nippy.host/mcp——授权流程与 nippy login 使用相同的 OAuth 同意页面（Streamable HTTP、 OAuth 2.1 + PKCE、动态客户端注册）。远程服务提供相同的工具，另有 start_upload / start_revision / finalize_upload / abort_upload，可用于任何类型和大小的文件。

Claude Desktop、Claude Code 或 Cursor（本地，stdio）：

npx nippy-mcp                       # Claude Desktop
npx nippy-mcp --client claude-code  # Claude Code
npx nippy-mcp --client cursor      # Cursor

然后只需提出请求：“将此页面发布到 Nippy”。工具包括 publish_site、 update_site（URL 不变，仅修改指定文件）、list_sites、 list_permanent_sites、read_site_file、check_site_name，以及付费套餐的 密码、SEO 元数据、搜索索引和访客分析工具。较小的二进制文件（图片、PDF、字体） 会以内联方式通过 encoding: "base64" 发送——每个文件最多 4 MB，每次调用最多 12 MB；更大的文件请使用 nippy deploy。

预览

助手会反复迭代，而大多数草稿都只是临时内容——因此发布提供两个 动词。publish_preview 会将草稿发布到 <slug>.preview.nippy.site：自 上次更新起 24 小时后过期，不会被编入索引，且不会占用站点名额。 update_preview 可更新预览（并重置计时），list_previews 会显示当前 有效的预览及其剩余时间，discard_preview 则可丢弃预览。

当草稿值得保留时，promote 会将其设为永久站点——既可以创建新 站点，也可以替换现有站点的内容。预览 URL 不会失效：它会变成指向 该站点的永久重定向，因此你已分享的链接仍可使用。

publish_site 保持不变，仍表示“永久发布，并计入套餐限额”。 免费账户一次可保留 5 个有效预览；付费套餐不设上限。

在 CI 中使用

# any CI — the token comes from a secret
- run: NIPPY_TOKEN=${{ secrets.NIPPY_TOKEN }} npx @nippyhost/cli deploy ./dist --site docs --json

NIPPY_TOKEN 始终优先于已存储的登录凭据。

令牌与安全

• nippy login 使用与 Nippy AI 连接器相同的 OAuth 同意页面； 登录记录会显示在 设置 → API 与 MCP 的 已连接的应用下，你可以随时断开连接。CI 请改为在此处创建令牌—— 免费账户即可使用（1 个在线站点、25 MB，无需银行卡）。
• 令牌具有限定范围（部署/读取/管理/分析），且可撤销。令牌永远无法删除站点、操作账单或管理账户——这些操作需要通过控制面板完成。
• 套餐限额由服务端强制执行，并如实告知：达到限额时，会明确说明具体限额。

说明

• 不含 index.html 的文件夹会自动变成画廊（包含所有图片）或整洁的下载页面（包含多种文件）。
• 压缩包会在上传前在本地解压。
• 站点名称是 nippy.site 的子域名：由小写字母、数字和连字符组成。如果名称已被占用，系统会返回下一个可用的后缀。

MIT · nippy.host · 帮助

---

关于此代码仓库

这是 @nippyhost/cli 和 nippy-mcp 的源码镜像。开发工作在 Nippy 单体代码仓库中进行（在那里生成 API 客户端并运行测试套件）；此处发布源码，供阅读、提交问题和获取发行版本。

• cli/ — nippy 命令 + MCP 服务（@nippyhost/cli）
• sdk/ — 发布 SDK：init → 预签名上传 → finalize 流程
• upload-rules/ — 与平台共享的客户端验证规则

错误报告和功能请求 → 问题。