Snowkit

Snowkit

在你的电脑上运行的私有工具。

Snowkit 可以合并和拆分 PDF、生成二维码、整理 JSON 和 SQL、统计字数等。它既可以通过命令行使用，也可以接入支持 Model Context Protocol（MCP）的 AI 应用，让你的助手真正处理文件。

你的文件不会离开电脑。Snowkit 不需要账户，不会通过互联网发送任何内容，也不会留存副本。它只读取你指定的文件，并将结果写在这些文件旁边。

可以做什么

工具	功能
pdf_merge	按照你指定的顺序，将两个或更多 PDF 合并为一个
pdf_split	将 PDF 拆分为每页一个文件、每几页一个文件，或按页码范围拆分
pdf_extract_pages	将选定的页面复制到新的 PDF 中，也可用于调整页面顺序或删除页面
pdf_rotate	将全部或部分页面旋转 90、180 或 270 度
pdf_info	显示页数、页面尺寸、PDF 版本、表单字段和文档详情
markdown_to_pdf	将 Markdown 转换为排版整洁、分页清晰的 PDF
qr_code	为链接或任意文本生成 SVG 或 PNG 格式的二维码
json_format	美化或压缩 JSON，同时确保大数值精确无误
json_validate	检查 JSON，也可选择使用 JSON Schema 进行验证
sql_format	格式化或压缩 SQL
text_stats	统计单词、字符和句子，并提供阅读时间和可读性信息
text_transform	转换大小写、生成 URL 标题，或删除重复行
color_convert	在 hex、RGB、HSL、HSV 和 OKLCH 之间转换颜色，并检查对比度
cron_explain	用通俗易懂的英文解释 cron 计划，并列出接下来的运行时间
image_info	显示 JPEG、PNG 或 WebP 照片透露的信息：相机、日期和拍摄地点
image_strip_metadata	移除照片中隐藏的位置信息、相机详情和注释，同时保留原始图像
head_tags	为网页生成标题、描述、规范链接、Open Graph 和 Twitter 标签
head_check	检查网页 HTML 中缺失或过长的 head 标签，并说明需要修正的内容

每项结果末尾都附有对应工具在 snowkit.io 上的链接，方便你在浏览器中查看。

在 AI 应用中使用

你需要安装 Node.js 18 或更高版本。无需安装其他内容：下面的命令会在首次运行时获取 Snowkit。

Claude Desktop

打开 Settings，然后依次选择 Developer 和 Edit Config，将 Snowkit 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "snowkit": {
      "command": "npx",
      "args": ["-y", "snowkit"]
    }
  }
}

重启 Claude Desktop。如果 Windows 上找不到 npx，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "snowkit"]。

Claude Code

claude mcp add snowkit -- npx -y snowkit

Cursor

打开 Cursor Settings，然后依次选择 MCP 和 Add new MCP server；或者将以下内容添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "snowkit": {
      "command": "npx",
      "args": ["-y", "snowkit"]
    }
  }
}

Gemini CLI

将以下内容添加到 ~/.gemini/settings.json：

{
  "mcpServers": {
    "snowkit": {
      "command": "npx",
      "args": ["-y", "snowkit"]
    }
  }
}

其他 MCP 应用

Snowkit 是一个通过标准输入和输出通信的标准 MCP 服务。将应用指向命令 npx -y snowkit 即可。

接下来，只需提出请求，例如：

• “合并我 Downloads 文件夹中的 invoice-march.pdf 和 invoice-april.pdf。”
• “从 contract.pdf 中提取第 3 到第 5 页。”
• “生成一个 QR 码 PNG，用于 https://example.com，并保存到我的桌面。”
• “这个 JSON 有效吗？”

通过命令行使用

npx snowkit pdf merge a.pdf b.pdf -o both.pdf
npx snowkit pdf split report.pdf --every 2
npx snowkit pdf split report.pdf --range 1-3 --range 4-
npx snowkit pdf extract report.pdf --pages "1, 4-6"
npx snowkit pdf rotate scan.pdf --angle 90 --pages 2
npx snowkit pdf info report.pdf
npx snowkit md2pdf notes.md --page letter --numbers
npx snowkit qr "https://example.com" -o qr.png
npx snowkit json format data.json --sort
npx snowkit json validate data.json --schema schema.json
npx snowkit sql format query.sql
npx snowkit text stats essay.txt
npx snowkit text case title headings.txt
npx snowkit text dedupe emails.txt --ignore-case
npx snowkit color "#336699" --against white
npx snowkit cron "*/15 9-17 * * 1-5"
npx snowkit --help

文本命令会读取你指定的文件；如果通过管道传入文本，则会读取标准输入，因此可以在脚本中使用：

curl -s https://api.example.com/items | npx snowkit json format

使用 npm install -g snowkit 安装一次后，就可以省略 npx。

它如何处理你的文件

• 它只读取你指定的文件，只写入你要求的位置；如果你没有说明，则写入原文件所在的位置。
• 除非你设置 overwrite（或在命令行中传入 --overwrite），否则它绝不会替换现有文件。
• 它绝不会连接互联网。每个工具都在你自己的计算机上运行。
• 对于受密码保护的 PDF，它会保留原样，并显示清晰的提示。

须知

• markdown_to_pdf 使用内置字体，支持西欧语言。Markdown 中的图片会被省略。
• pdf_rotate 会保留文件中的其他内容。合并、拆分和提取操作会直接复制页面，因此不会保留原文件中的书签和文档详细信息。
• 错误信息会说明出了什么问题以及如何修复，让你的助手能够合理地重试。

许可证

MIT。请参阅 LICENSE。