snipper-mcp

snipper-mcp — SnipperApp 3 内の MCP サーバー

SnipperApp 3 は、macOS 用のネイティブコードスニペットマネージャーです。独自の Model Context Protocol サーバーを搭載しており、AI アシスタントがライブラリ内のスニペットを検索、読み取り、作成、整理できます。インストールは不要です。サーバーはアプリにバンドルされた stdio バイナリです。

このリポジトリでは、サーバーのインターフェイスについて説明しています。サーバー自体はアプリの一部であり、Swift MCP SDK を基盤に Swift で構築されています。

要件

• SnipperApp 3（Mac App Store、7 日間の無料トライアル）：https://apps.apple.com/us/app/snipperapp-3-code-snippets/id6757330954?mt=12
• macOS 15 以降（Apple Silicon または Intel）

Claude Desktop へのインストール（ワンクリック）

最新リリースから snipperapp-1.0.2.mcpb をダウンロードして開くと、Claude Desktop が拡張機能としてインストールします。バンドルには、SnipperApp 3 内のサーバーを見つけて stdio を引き継ぐ小さなランチャー（mcpb/server/index.js）のみが含まれています。アプリがなくても initialize と tools/list（mcpb/server/tools.json 内のマニフェスト）には応答し、すべてのツール呼び出しは未インストールであることを示す明確なエラーを返します。レジストリのイントロスペクションチェックでは、Dockerfile を使ってこのモードを実行します。

セットアップ（手動）

Claude Code：

claude mcp add snipper -- "/Applications/SnipperApp 3.app/Contents/MacOS/snipper-mcp"

Claude Desktop、Cursor（.cursor/mcp.json）、Windsurf（~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "snipper": {
      "command": "/Applications/SnipperApp 3.app/Contents/MacOS/snipper-mcp"
    }
  }
}

詳しいガイド：https://snipperapp.com/docs/mcp-integration

ツール（25 個）

分野	ツール
スニペット	search_snippets、get_snippet、create_snippet、update_snippet、delete_snippet
フォルダー	list_folders、create_folder、update_folder、delete_folder
タグ	list_tags、create_tag、delete_tag、add_tag_to_snippet、remove_tag_from_snippet
添付ファイル	list_attachments、get_attachment、create_attachment、delete_attachment
整理	list_workspaces、list_storages、list_groups、list_languages
Hub（公開スニペット）	search_hub、get_hub_snippet、import_from_hub

すべてのツールには title と、確認が必要な操作をクライアントが判断するための MCP アノテーションが付いています。読み取りツール 12 個には readOnlyHint、削除／タグ解除ツール 5 個には destructiveHint、Hub ツール 3 個には openWorldHint が付いています。

サーバーはアプリと同じローカル SQLite データベースを読み書きするため、アシスタントが保存した内容はすぐに SnipperApp に表示されます。サーバーにデータが送信されることはありません。Hub ツールを使用した場合に限り、公開 Hub API が呼び出されます。

プロンプトの例

• 「バックオフ付き再試行ヘルパーをスニペットから検索して、ここに貼り付けてください。」
• 「この関数を Work ワークスペースの Utilities フォルダーに、postgres タグを付けてスニペットとして保存してください。」
• 「networking タグが付いた Swift スニペットを一覧表示してください。」

プライバシーポリシー

ポリシー全文：https://snipperapp.com/privacy

サーバーが収集する情報。 ありません。snipper-mcp には、独自の分析機能、テレメトリー、クラッシュレポート機能はありません。このリポジトリの MCPB ランチャーはネットワークリクエストを一切行いません。標準入出力を同梱バイナリに渡すか、静的ファイルから tools/list に応答するだけです。

データの使用と保存方法。 サーバーは、Mac 上の SnipperApp 3 専用コンテナ内にある、SnipperApp 3 と同じローカル SQLite データベースを読み書きします。スニペット、フォルダー、タグ、添付ファイルがデバイスから外部に送信されることはありません。ただし、同期ストレージを自分で有効にした場合を除きます。利用できる同期ストレージは iCloud（Apple CloudKit のプライベートデータベースで、開発者は読み取れません）または GitHub Gist（お使いの GitHub 認証情報を使用する、ご自身のアカウント）です。

第三者との共有。 サーバーによる共有はありません。3 つの Hub ツール（search_hub、get_hub_snippet、import_from_hub）は、アシスタントが呼び出した場合に限り、公開 SnipperApp Hub API を呼び出します。送信されるのは検索語またはスニペット ID のみで、ライブラリ内の情報は送信されません。スニペットの内容はアップロードされません。広告主やデータブローカーに販売または共有されることもありません。

データの保持期間。 スニペットは Mac 上に保存され、削除するまで残ります。SnipperApp 3 内で（または delete_snippet を使って）削除すると、ローカルデータベースと有効にした同期ストレージの両方から削除されます。開発者が保持するサーバー側のコピーはありません。Hub へのリクエストはアカウントに紐付けられず、ユーザーごとの履歴として保存されることもありません。

お問い合わせ。 ご質問、またはご自身について保持されている情報の確認や削除のご依頼は、[email protected] までご連絡ください。

このリポジトリについて

• mcpb/ — MCPB 拡張機能です。manifest.json、icon.png、ランチャー server/index.js が含まれます。npx @anthropic-ai/mcpb pack mcpb snipperapp-<version>.mcpb で再ビルドできます。
• server.json — 公式 MCP レジストリのエントリー（mcp-publisher publish）です。
• ランチャーとこれらのドキュメントは MIT ライセンスです。SnipperApp 3 と同梱の snipper-mcp バイナリはプロプライエタリです。

サポート

バグ報告、機能リクエスト、プライバシーに関するご質問は、[email protected] までお寄せください。ドキュメント：https://snipperapp.com/docs/mcp-integration