Snowkit

Snowkit

コンピューター上で動作するプライベートツールです。

Snowkit は PDF の結合や分割、QR コードの作成、JSON や SQL の整形、単語数のカウントなどを行います。コマンドラインから使えるほか、Model Context Protocol（MCP）に対応した AI アプリにも接続できるため、アシスタントがファイルを使って実際の作業を行えます。

ファイルがコンピューターの外に出ることはありません。Snowkit はアカウントを必要とせず、インターネット経由でデータを送信せず、コピーも保存しません。指定したファイルを読み込み、その隣に結果を書き込みます。

できること

ツール	機能
pdf_merge	指定した順序で、2 つ以上の PDF を 1 つに結合します
pdf_split	PDF をページごと、数ページごと、またはページ範囲ごとに分割します
pdf_extract_pages	指定したページを新しい PDF にコピーします。ページの並べ替えや削除もできます
pdf_rotate	すべて、または一部のページを 90、180、270 度回転します
pdf_info	ページ数、ページサイズ、PDF バージョン、フォームフィールド、文書の詳細を表示します
markdown_to_pdf	Markdown を見やすく、ページ分けされた PDF に変換します
qr_code	リンクや任意のテキストから、SVG または PNG の QR コードを作成します
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	ページのタイトル、説明、canonical、Open Graph、Twitter タグを作成します
head_check	ページの HTML を確認し、不足しているタグや長すぎる head タグを検出して、修正方法を示します

各結果の末尾には、ブラウザーで確認したい場合に備えて、対応するツールの snowkit.io へのリンクが表示されます。

AI アプリで使う

Node.js 18 以降が必要です。それ以外にインストールするものはありません。以下のコマンドを初めて実行すると、Snowkit が取得されます。

Claude Desktop

Settings、Developer、Edit Config の順に開き、claude_desktop_config.json に Snowkit を追加します。

{
  "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 ページを取り出して。」
• 「https://example.com の QR コードを PNG で作って、デスクトップに保存して。」
• 「この 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 をご覧ください。