AppScreen

@appscreen/mcp

AppScreen 用の MCP サーバーです。Claude Desktop、Claude Code、Cursor、Codex など、MCP に対応したあらゆるエージェントから、App Store／Play Store のスクリーンショットを生成できます。

インストール

# Latest, no install — recommended for end users
npx -y @appscreen/mcp

設定（Claude Desktop）

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "appscreen": {
      "command": "npx",
      "args": ["-y", "@appscreen/mcp"],
      "env": {
        "APPSCREEN_API_KEY": "mcm_live_…"
      }
    }
  }
}

匿名で利用する場合は APPSCREEN_API_KEY を省略してください（生涯で5回までレンダリングでき、その後はサインアップが必要です）。

設定（その他のクライアント）

• Claude Code： claude mcp add appscreen -- npx -y @appscreen/mcp

• Cursor： .cursor/mcp.json — 上記と同じ JSON 形式です。

• Codex： codex mcp add appscreen -- npx -y @appscreen/mcp、または ~/.codex/config.toml に追加します。

  [mcp_servers.appscreen]
  command = "npx"
  args = ["-y", "@appscreen/mcp"]
  env = { APPSCREEN_API_KEY = "mcm_live_…" }
  

ツール

• render_screenshots — 画面（レイアウト JSON）と画像ファイルを受け取ります。jobId（キー認証／非同期）またはダウンロードリンク（匿名／インライン）を返します。匿名での無料利用は生涯5回までです。
• get_render_status — jobId の状態をポーリングします。完了すると、ステータスと署名付きダウンロード URL を返します。

画像は base64 ではなくパスで渡す

サーバーはローカルで動作するため、ファイルパスを指定してください。ファイルのバイトデータはディスクから読み込まれます。実際のスクリーンショットを base64 にエンコードして呼び出しに含めないでください。LLM が18,000～90,000文字の base64 文字列を出力すると、途中で文字が欠落し、その箇所より下の PNG が黒くレンダリングされます。

"files": [
  { "name": "1.png", "path": "~/app/screenshots/home.png" },   // ✅ preferred
  { "name": "2.png", "path": "/abs/path/settings.png" }
]
// base64 is accepted only for tiny synthetic test images:
// { "name": "x.png", "base64": "iVBORw0KG..." }

バンドルのダウンロード URL は署名付きで、約1時間後に期限切れになります。URL を更新するには、再度ポーリングしてください。

クォータ

サインイン済みの利用は、クレジット単位で計測されます。1クレジット＝エクスポートした画像1枚です（画面数 × サイズ数 × 言語数）。エクスポートに失敗した場合、クレジットは返還されます。自動翻訳は無料です。MCP キーを使用すると、そのキーを作成したワークスペースのクレジットが消費されます。

プラン	クレジット／月	備考
Free	50	エクスポートごとに1サイズ、英語、エクスポートごとに画面10枚まで。1時間あたり3回のレンダリング。
Starter — $4 / mo	400	5サイズすべて、エクスポートごとに任意の3言語、自動翻訳。1時間あたり3回のレンダリング。
Pro — $8 / mo	2,500	15言語すべて、エクスポートごとに画面200枚まで。MCP を最大速度で利用可能。
Team — $29 / mo	8,000 pooled	3シートを含みます。MCP を最大速度で利用可能。

一回限りのクレジットパックは Free を含むすべてのプランで利用できます。100クレジットは $5、400クレジットは $15、1,500クレジットは $39で、12か月間有効です。匿名での利用（キーなし）はクレジットでは計測されず、生涯5回までです。

すべてのツール応答には _meta.quota = {used, cap, tier, resetAt} と、残りのクレジット数を示す balance が含まれます。また、レンダリングの送信時には、API から返された場合に cost も含まれます。サインイン済みの呼び出し元では、used と cap はクレジット数を示し（cap − used = balance）、tier はプラン ID です。匿名の呼び出し元では、これらは生涯5回のレンダリング回数を示し、tier は anon-mcp です。残りが半分未満になると、テキストコンテンツに短い通知（「残り N クレジット…」）が含まれます。残りが20％未満、またはゼロになると、応答に _meta.upgradeUrl も含まれます。

ワークスペースのクレジットでは足りないエクスポートは、HTTP 402 insufficient_credits で失敗します。エラーテキストにはコストと残高が表示されます。詳細は https://appscreen.co/pricing をご覧ください。

環境変数

変数	用途
APPSCREEN_API_KEY	任意。https://appscreen.co/account/keys で取得する MCP キー（mcm_live_…）です。Free を含むすべてのプランで利用できます。プログラムから使用する ask_live_… API キーとは異なります。
APPSCREEN_BASE_URL	API URL を上書きします。デフォルトは https://api.appscreen.co です。
APPSCREEN_MCP_CLIENT	クライアント識別子を上書きします（MCP の初期化時に自動検出されます）。

ライセンス

MIT