snapWONDERS MCP (local)

snapWONDERS — 隠されたものを明らかに。あなたのものは隠したままに。

snapWONDERS MCP

AI アシスタントがお使いのマシン上のファイルを扱えるようにするローカルの MCP サーバーです。写真の中にファイルを隠したり、隠されたコンテンツを明らかにしたり、フォレンジック分析を実行したり、形式を変換したりできます。

Claude Desktop ──stdio──▶ snapwonders-mcp ──HTTPS──▶ snapwonders.com/api
   (your machine)          (your machine)

これが必要な理由

snapWONDERS にはすでに https://snapwonders.com/mcp にリモート MCP サーバーがあり、オーケストレーションには適しています。しかし、これはこちらのサーバー上で動作するため、あなたのファイルを見ることはできません。また、MCP のツール呼び出しで扱えるのはバイト列ではなく JSON です。デスクトップ上に写真があるアシスタントがセッションを作成しても、ファイルを置く場所がありません。

このサーバーはファイルがある場所で動作します。パスを指定すると、ファイルをローカルで読み込み、会話とともに HTTPS 経由でアップロードします。違いはそれだけですが、これによって、アシスタントが使えるターミナルを備えていない Claude Desktop から snapWONDERS を利用できるようになります。

結果も同じ方法で返されます。隠す、明らかにする、変換する操作を行うと、出力がディスクに書き込まれ、保存先がアシスタントに伝えられます。別の HTTP クライアントで取得する必要があるアセット ID が返されるわけではありません。

インストール

https://snapwonders.com/profile/api-keys から API キーを取得してください（無料アカウントが必要です。また、メールアドレスの確認も必要です。未確認のアカウントのキーは常に拒否されます）。

クライアントで uvx を実行できる場合は、事前にインストールするものはありません。

uvx snapwonders-mcp

または、きちんとインストールしてください。

pip install snapwonders-mcp

クライアントを設定する

Claude Desktop

Windows では %APPDATA%\Claude\claude_desktop_config.json、macOS では ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "snapwonders": {
      "command": "uvx",
      "args": ["snapwonders-mcp"],
      "env": { "SNAPWONDERS_API_KEY": "sw_your_key_here" }
    }
  }
}

Claude Code

claude mcp add snapwonders --env SNAPWONDERS_API_KEY=sw_your_key_here -- uvx snapwonders-mcp

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）：

{
  "mcpServers": {
    "snapwonders": {
      "command": "uvx",
      "args": ["snapwonders-mcp"],
      "env": { "SNAPWONDERS_API_KEY": "sw_your_key_here" }
    }
  }
}

キーは環境変数から読み込まれ、ツールの引数として渡されることはありません。そのため、モデルのコンテキストを通じて送られることもなく、会話記録やログに残ることもありません。

パスワードは別物です。そのことを知っておいてください。 hide_file と reveal_file は、パスフレーズをツールの引数として受け取ります。パスフレーズを指定できるのはユーザーだけであり、呼び出しごとに変わるためです。つまり、パスフレーズはモデルのコンテキストを通じて送られ、クライアントのログや会話記録に表示される場合があります。アシスタント主導のフローでは、これを避ける方法はありません。API キーに対する配慮はパスフレーズには適用されないため、アシスタントを通じて隠すものは、それに応じて慎重に扱ってください。

このサーバーは、読み取り可能なファイルならどれでもアップロードできます。 これがこのサーバーの目的です。アシスタントがパスを要求すると、ファイルが snapWONDERS に送信されて処理されます。つまり、「~/.ssh/id_rsa を分析して」というリクエストがあれば、実際にそのファイルが処理されます。また、アシスタントが読み込んだウェブページやドキュメントの指示に従い、そのように利用しようとする可能性もあります。実際の防護策となるのは、MCP クライアントのツール承認プロンプトです。承認する前に、ツール呼び出しのパスを確認してください。

ツール

ツール	機能
analyse_file	画像または動画をローカルでフォレンジック分析します。A〜Fの評価、メタデータの露出、改ざんの証拠、隠されたコンテンツを確認できます。顔検出とOCRはオプションです。
hide_file	画像または動画をカバーとしてファイルを隠し、結果をディスクに保存します。
reveal_file	画像または動画に隠されたコンテンツを抽出し、ディスクに保存します。
convert_file	画像または動画を別の形式に変換し、出力をディスクに保存します。

4つのツールは、それぞれ1つのタスク全体を実行します。基盤となるREST APIは、セッション → アップロード → ジョブ → ポーリング → 結果という手順です。各ステップにつき1回の呼び出しとして公開すると、モデルは5段階の状態を維持する必要があり、誤ることもあります。オーケストレーションはここでPythonを使って行うため、確実に実行されます。

hide_fileのパスワードは復元できません。 保存されることはなく、リセットする方法もありません。これを使って何かを隠す前に、ユーザーがパスフレーズを把握していることを確認してください。

リモートサーバーを使う場合

https://snapwonders.com/mcpはインストール不要です。ファイルがすでにサーバーからアクセスできる場所にある場合や、セッションとジョブのオーケストレーションだけが必要な場合に適しています。ファイルがユーザーのマシン上にある場合は、このローカルサーバーを使ってください。デスクトップアシスタントでは、ほとんどの場合こちらに当たります。

使用するアップロード方式

状況に応じて自動的に選択されるため、選ぶ必要はありません。Python SDKは、サーバーが報告する上限（現在95 MB）以下のファイルを単一の直接アップロードで送信し、上限を超える場合は上記の再開可能なTUSプロトコルに切り替えます。

snapWONDERSが生まれた理由

このプロジェクトは、息子のHueyと始まりました。

Hueyは視力を失い、4歳のときに法的に失明と認定されました。何年も前、車の中で一緒にHueyifyに取り組んでいたとき、彼はそのアイデアをデジタルメディアにも応用できると言い張りました。写真に物語を埋め込めば、視覚に障害のある人が、その写真に込められた個人的な背景や思い出、感情を知ることができます。ほかの人には見えない、伝える相手だけのためのものです。

彼はその考えに胸を躍らせていました。技術的な難しさに気が引けたこと、そしてそれを口に出していたことは認めざるを得ません。Hueyにとってはすべて筋が通っていたので、彼のがっかりした表情が何度も思い浮かびました。Hueyは16歳で亡くなりました。あの会話を忘れることはできませんでした。

まずsnapWONDERSが生まれ、デジタルメディアに実際に何が含まれているのか、そして誰がそれを見られるのかを理解することを目指しました。その後にVaultifyが生まれました。これは、Hueyが語ったものに私が最も近づけた作品です。2026年9月時点で、snapWONDERSとVaultifyは600万件を超えるメディアジョブを処理しています。

物語の全文はhttps://vaultify.snapwonders.com/our-storyにあります。

皆さまに平和がありますように。
Kenneth Springer

ライセンス

MIT — LICENSEを参照してください。このライセンスの適用対象はこのサーバーのみです。このサーバーが呼び出すsnapWONDERS APIはプロプライエタリです。