StoreShots

StoreShots MCP

Cursor、Claude、その他の MCP クライアントから、生のアプリのスクリーンショットを、洗練された App Store と Google Play 向けのマーケティング用スクリーンショットに仕上げます。

これは、ホスト型の StoreShots API と通信する、小規模な stdio MCP サーバーです。レンダリングはサーバー上で行われるため、お使いのマシンに Chrome、Puppeteer、デザインツールを用意する必要はありません。エージェントにスクリーンショットと見出しをいくつか渡すと、ストアにそのまま掲載できる PNG（または ZIP）をプロジェクト内に保存します。

• 1 セットあたり 1～5 枚のスクリーンショット。ローカルファイルまたは URL に対応
• 厳選された 5 種類のスタイル：glow、midnight、sunset、mint、trailing。カスタムカラーにも対応
• デバイスフレーム：iphone、iphone-duo、android、ipad
• 1 回の呼び出しですべての必須ストアサイズに対応：ios-6.9（1320×2868）、ios-6.5（1242×2688）、android-phone（1080×1920）、ipad-13（2064×2752）
• 各スライドに見出しとキャプションを設定
• ZIP や PNG をプロジェクトに直接ダウンロード

クイックスタート

1. 無料の API キーを取得する

https://storeshots.qaimos.co.uk/account.html でメールアドレスを登録します。キー（ss_...）は一度しか表示されないため、安全な場所にコピーしてください。

2. MCP クライアントにサーバーを追加する

Cursor：これを ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。上の「Install in Cursor」ボタンも使用できます。

{
  "mcpServers": {
    "storeshots": {
      "command": "npx",
      "args": ["-y", "storeshots-api-mcp"],
      "env": { "STORESHOTS_API_KEY": "ss_your_key_here" }
    }
  }
}

Claude Desktop：Settings → Developer → Edit Config を開き、同じブロックを claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "storeshots": {
      "command": "npx",
      "args": ["-y", "storeshots-api-mcp"],
      "env": { "STORESHOTS_API_KEY": "ss_your_key_here" }
    }
  }
}

Claude Code：

claude mcp add storeshots --env STORESHOTS_API_KEY=ss_your_key_here -- npx -y storeshots-api-mcp

VS Code、Windsurf、その他のクライアント：環境変数に STORESHOTS_API_KEY を設定し、stdio で npx -y storeshots-api-mcp を実行します。

Node.js 18.17 以降が必要です。

3. エージェントに依頼する

./shots/home.png と ./shots/stats.png から、midnight スタイルで App Store 用のスクリーンショットを作成してください。見出しは「Build habits that stick」と「See your progress」にして、./store-assets に保存してください。

ツール

ツール	機能
list_styles	使用できるスタイルと、それぞれのカラーおよびレイアウトを一覧表示します
list_devices	デバイスフレームとストアの出力サイズを一覧表示します
generate_screenshots	screenshots（1～5 個のパスまたは URL）から 1 セットをレンダリングします。任意の入力：style、device、targets[]、headlines[]、captions[]、appName、theme（カラーの上書き）、download_to、download_format（zip | png | both）。jobId を返します
get_output	ジョブの ZIP や PNG を output_dir にダウンロードします。出力は 24 時間保持されます
get_balance	有料クレジット、今月残っている無料セット数、利用可能なクレジットパックを表示します
buy_credits	クレジットパックの Stripe Payment Link を返します。リンクはブラウザーで開きます。このツールが課金することはありません

設定

変数	必須	デフォルト
STORESHOTS_API_KEY	はい	なし。無料キーは account.html で取得できます
STORESHOTS_API_URL	いいえ	https://storeshots.qaimos.co.uk/api.php
STORESHOTS_OUTPUT_DIR	いいえ	~/StoreShots（デフォルトのダウンロードフォルダー）
STORESHOTS_TIMEOUT_MS	いいえ	300000

料金

• Free：月に3セット。小さな「Made with StoreShots」ウォーターマークが付きます
• Starter：3ドルで10セット。ウォーターマークは付きません
• Pro：5ドルで20セット。ウォーターマークは付きません

1セットはgenerate_screenshotsの呼び出し1回分で、指定したすべてのサイズが含まれます。buy_creditsまたはstoreshots.qaimos.co.ukで購入できます。

プライバシー

スクリーンショットはHTTPS経由でStoreShots APIにアップロードされ、そこでレンダリングされた後、24時間後に削除されます。APIキーはX-API-Keyヘッダーとして送信されます。

開発

npm install
npm run inspect   # opens the MCP Inspector against src/index.js

npm testを実行すると、このリポジトリには含まれていないStoreShots PHP APIのローカルコピーに対してエンドツーエンドテストが実行されます。

リンク

• Webサイト：https://storeshots.qaimos.co.uk/
• npm：https://www.npmjs.com/package/storeshots-api-mcp
• MCP Registry：uk.co.qaimos.storeshots/storeshots
• Issue：https://github.com/qaimos/storeshots-mcp/issues

ライセンス

MIT