Summer Engine について
Summer Engineは、MCPサーバー、CLI、ゲーム開発スキルを通じて、AIコーディングエージェントをゲームエンジンに接続します。ローカルでのマルチプレイヤーゲームの制作とテストに加え、アセットや公開のクラウド操作にも対応します。
主な機能
- 01ゲーム制作とテストのためのMCPツール
- 02ゲーム開発スキルとテンプレート
- 03セットアップ、プロジェクト、公開用CLI
- 04マッチメイキングやリーダーボードなどのマルチプレイヤー機能
- 05アセット、公開、分析のクラウドツール
活用シーン
- 01AIコーディングエージェントでゲームを制作、テスト
- 02マッチメイキングを使ったマルチプレイの構築
- 03ゲームアセットの生成と管理
- 04ゲームを公開してプレイヤー分析を確認
MCP 対応
ローカルの `summer mcp` サーバーは、実行中のSummer Engineアプリを操作し、シーン制作、スクリプト作成、ゲーム実行、スクリーンショット、エラー確認を行います。`summer login` 後はクラウド操作も利用でき、別のホスト型MCPサーバーはローカルエンジンツールを含まないクラウド機能を提供します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.summerengine.com/mcpclaude mcp add --transport http summerengine-summer https://mcp.summerengine.com/mcp{"mcpServers":{"summerengine-summer":{"type":"http","url":"https://mcp.summerengine.com/mcp"}}}Cursor で開く{"servers":{"summerengine-summer":{"type":"http","url":"https://mcp.summerengine.com/mcp"}}}VS Code で開く{"mcpServers":{"summerengine-summer":{"type":"http","url":"https://mcp.summerengine.com/mcp"}}}{"mcpServers":{"summerengine-summer":{"serverUrl":"https://mcp.summerengine.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
Summer Engine:MCP サーバー、CLI、スキル
AI のために作られたゲームエンジン。
どんなエージェントでも、マルチプレイヤーゲームを構築、テスト、公開できます。MCP サーバー・ゲーム開発スキル・summer CLI を、1 つの npm パッケージ summer-engine にまとめています。
ウェブサイト · ドキュメント · CLI のセットアップ · MCP のセットアップ
インストール
- 今すぐゲームを始める(Node 22+):
npx -y summer-engine@latest dev。Summer Engine アプリがない場合は、インストール前に確認を求めます(約 660 MB、無料)。スタータープロジェクトをここに作成し(このフォルダーにほかのファイルがある場合は./my-gameに作成)、開きます。すぐにエージェントを利用できます。ビルドにサインインは不要です。 - チャットアプリ(Claude、ChatGPT、Cursor など):
https://mcp.summerengine.com/mcpを追加します。インストールは不要です。 - Homebrew:
brew install summerengine/tap/summer - npm(Node 22+):
npm install -g summer-engine
CLI のみ(summer-engine 4.2.0 以降)で、MCP サーバーを使わない場合:summer setup --cli。summer ops search "publish my game" を使えば、サインインの有無にかかわらず、あらゆる操作を検索できます。
接続
クラウド作業:https://mcp.summerengine.com/mcp。 インストールは不要です。エージェントに URL を追加して、Summer アカウントに一度サインインします。するとエージェントは、アセット(画像、3D モデル、モーション、効果音、音楽、音声、動画)を作成し、Summer のアセットライブラリを検索・ダウンロードし、ゲームを計画して、プロジェクト、ストア、公開、価格、分析、A/B テスト、チーム、Studio を管理します。エンジン用ツールはありません。エンジン用ツールを使う場合は、以下のローカルサーバーを使用してください。
| エージェント | ホストサーバーの追加方法 |
|---|---|
| Claude Code | claude mcp add --transport http summer-cloud https://mcp.summerengine.com/mcp を実行し、その後 /mcp でサインインします |
| Codex | codex mcp add summer-cloud --url https://mcp.summerengine.com/mcp を実行し、その後 codex mcp login summer-cloud を実行します |
| Cursor | Cursor に追加するか、~/.cursor/mcp.json の mcpServers に "summer-cloud": {"url": "https://mcp.summerengine.com/mcp"} を追加します |
| VS Code | VS Code に追加するか、code --add-mcp '{"name":"summer-cloud","type":"http","url":"https://mcp.summerengine.com/mcp"}' を実行します |
| Devin Desktop(旧 Windsurf) | ~/.config/devin/mcp_config.json(Windows では %APPDATA%\devin\mcp_config.json)の mcpServers に "summer-cloud": {"serverUrl": "https://mcp.summerengine.com/mcp"} を追加します |
| Claude Desktop、claude.ai | Settings > Connectors > Add custom connector を選び、URL を貼り付けます |
エンジン作業:npx -y summer-engine@latest setup <agent> --yes(Node 22 以降が必要です)。スキルとともに、ローカルサーバー(summer mcp)をエージェントの設定に書き込みます。ローカルサーバーは、お使いのマシン上の Summer Engine アプリを操作します。シーンの構築、スクリプトの作成、ゲームのプレイ、スクリーンショットの撮影、エラーの読み取りができます。summer login の後はすべてのクラウド操作も実行できるため、エージェントに必要なサーバーは 1 つだけです。または、始め方のプロンプトを貼り付けると、エージェントがすべての手順を実行します。
CLI のみ(summer-engine 4.2.0 以降):npx -y summer-engine@latest setup <agent> --cli --yes。 MCP サーバーはありません。エージェントはシェル内のコマンドとして Summer を実行します。セットアップでは、エージェント用のスキルと、コマンドのガイドである summer-cli をインストールし、MCP エントリは書き込みません。エージェントは summer login でサインインし、summer ops search "<what you want>" で操作を見つけて、summer <area> <action> --<field> <value> として実行します。--dry-run、--wait、--json を指定できます。エンジンコマンド(summer engine …)は、お使いのマシン上の Summer Engine アプリを操作します。各スキルの末尾には、そのスキルに記載された各ツールのコマンドをまとめた表があります。アセット関連のスキルだけを使う場合は --assets-only を追加します。--no-mcp は --cli と同じです。
ChatGPT と Claude のコネクタディレクトリでは、ツール一覧が固定された、審査済みの 2 種類のストア版を使用します。https://mcp.summerengine.com/chatgpt(ゲーム、アセット、生成。公開機能と請求リンクはありません)と、https://mcp.summerengine.com/directory(ストア、公開、Grow の読み取り。画像、3D、音声、動画の生成はありません)です。これらは 3.x のツール名を維持し、summer_search や summer_call はありません。それ以外のすべてには /mcp を使用してください。
これは何か
Summer Engine は、AI のために構築されたゲームエンジンです。このリポジトリは、AI コーディングエージェント(Claude Code、Cursor、Codex、Copilot など)を Summer Engine に接続します。エージェントはエンジン内でゲーム全体を構築し、テストして、summer.games で公開し、プレイヤーがどのようにプレイしたかを読み取ります。
| パート | 機能 |
|---|---|
MCP サーバー(summer mcp) | 実行中のエディターを操作するためにエージェントが呼び出すツールです。シーンの構築、スクリプトの作成、ゲームのプレイ、スクリーンショットの撮影、エラーの読み取りができます。summer login の後は、アセット、プラン、ストア、公開、価格、分析などのクラウド操作も実行します。 |
| スキル | エージェントが読み込むゲーム開発のノウハウです。移動、戦闘、マルチプレイヤー、VFX、オーディオ、UI、レベルデザインなどが含まれます。 |
CLI(summer) | エンジンのインストール、サインイン、エージェントのセットアップ、テンプレートからのプロジェクト作成、ゲームの公開を行います。 |
このリポジトリはエンジンそのものではありません。CLI が Summer Engine アプリをダウンロードします。
Summer をインストールすると、エージェントは次のことができます。
- 本格的なゲームを構築する:ライブ MCP ツールを通じて、シーン、スクリプト、物理演算、UI を扱います。
- マルチプレイヤーゲームを構築する:Summer 独自のネットワーク機能を使って、マッチメイキング、パーティー、リーダーボード、プレイヤーデータ、ワールドのセーブに対応します。
- ゲームに分析機能を追加して、その結果を読み取る:ストアページの閲覧数、起動数、プレイセッション数、プレイ時間、独自のイベントを確認できます。
- ゲームを公開する:summer.games ストアに、ストアページ、アート、ビルド、非公開プレビューリンク、リリースを公開します。公開前には Summer のストア審査が行われます。
- 実績のあるレシピを利用する:スキル、テンプレート、リファレンスを、1 つのインデックスから検索できます。
- 自分の作業を確認する:ゲームをプレイし、スクリーンショットを撮り、デバッガーを読み取り、実際のキーを押します。
- あらゆるプロジェクトを再開する:
.summer/のプロジェクトメモリにより、新しいエージェントが前のエージェントの中断地点から作業を再開できます。
エージェントに許可する操作を決める
Studio > Settings > Agent permissions には 6 つのスイッチがあります。これらは、Claude や ChatGPT など、接続するすべてのアプリに適用されます。現在は次のデフォルト設定が適用されます。設定はまもなく変更できるようになります。それまでは、Summer Games はエージェントによる公開前にゲームの所有者に確認を求め、価格、A/B テスト、メンバーの変更についても、あなたに確認を求めます。
| スイッチ | デフォルト | 確認なしでエージェントができること |
|---|---|---|
| 作成とビルド | オン | 下書き、シーン、プラン、アップロードを編集し、ビルドを開始します。 |
| クレジットの使用 | オン | 保有クレジットと自動チャージの上限内で、アセットを生成し、有料ビルドを実行します。 |
| 公開 | オン | ストアページ、バージョン、リリースを公開します。公開前には引き続き Summer のストア審査が行われます。 |
| 価格と公開後の変更 | オン | 価格やセールを変更し、A/B テストを開始または停止し、メンバーのロールを変更します。 |
| 完全に削除 | オフ:確認が必要 | ゲーム、アセット、ページ、リリースを削除します。 |
| ユーザーへの連絡 | オフ:確認が必要 | 実在するユーザーに招待やその他のメールを送信します。 |
スイッチがオフの場合、エージェントは先にあなたに確認を求めます。エージェントからリンク(https://www.summerengine.com/studio/approvals/<id>)が提示され、Studio のタブを開くと、承認と拒否を選べるリクエストが表示されます。あなたが承認するまで、何も変更されません。エージェントの権限や自動チャージの変更、ジャムへの参加、分析イベントの上限の変更については、エージェントは必ず事前に確認を求めます。Studio > Settings > Agent activity には、エージェントが変更した内容やリクエストした内容が新しい順に表示されます。価格、セール、国別価格、メンバーのロール、チーム名、イベントの上限は元に戻せます。
生成と有料ビルドには Summer クレジットを使用します。Studio Billing で自動チャージを有効にすると、クレジットが指定した額を下回ったときに、設定した月間上限まで、Summer が指定した額を追加します。エージェントが自動チャージを独自に変更することはできません。クレジットがなくなると、エージェントにはエラー no_credits と、次のリンクが 1 つ表示されます:https://www.summerengine.com/studio/credits。
Summer は、あなたが明示的に確認しない限り、ソフトウェアをインストールしません。CI の capability lint により、ライブラリエントリからエージェントにネットワーク、認証情報、パッケージマネージャーを操作するよう指示することは、構造上できないようになっています。
始めましょう:プロンプトをひとつ
AI エージェント(Claude Code、Cursor、Codex、Copilot、Devin Desktop など)を開き、次の内容を貼り付けます。
Summer Engine をインストールして、ゲームを作りましょう。github.com/summerengine/summer を読み、すでにインストールされているものを確認して、不足しているものをインストールし、スタータープロジェクトを開いて開発を始めましょう。
エージェントはこの README を読み、マシンにすでにあるものを確認して、不足している手順だけをシェルで実行します。
初回起動時には、次の処理が行われます。
- npx 経由で
summer-enginenpm パッケージ(約 2 MB)を取得します。 - Summer のゲーム開発スキルを
~/.claude/skills/(またはエージェントのユーザースキルディレクトリ)にインストールし、次のセッションからエージェントが読み込めるようにします。 npx -y summer-engine@latest devを実行します。Summer Engine アプリが未インストールの場合はダウンロードし(約 660 MB)、スタータープロジェクトを作成してエンジンで開きます。
開発にサインインは必要ありません。Summer のクラウドを初めて使うとき(アセットの生成や公開など)にのみ、エージェントからサインインを求められます。
シェルを使えないエージェント(Claude Desktop、ローカルサーバーを使うチャットアプリ)も、MCP 経由で同じ処理を行います。エンジンのインストールを許可すると、summer_projects_create_local がスタータープロジェクトを作成し、summer_projects_open_local がそれを開きます。
ほとんどのエージェント(Claude Code、Codex、Cursor、GitHub Copilot(VS Code、CLI、JetBrains)、Zed、Cline、Kilo Code、OpenCode、Devin Desktop、Antigravity、Kiro、Trae、Warp、Goose、Hermes、Crush、Amp、Factory、Junie、Qwen Code、Kimi Code、Grok Build、Mistral Vibe)では、セットアップ時に Summer Games(summer-games)にも接続されるため、エージェントはあなたの友達を確認したり、パーティーを始めたり、あなたの代わりにメッセージを送ったりできます。サインインは一度だけです。セットアップ時に、使っているエージェントに応じた手順が表示されます(Claude Code:/mcp を実行して summer-games を選択、Codex:/mcp login summer-games、Cursor:MCP 設定で summer-games の横にある Connect を選択)。ブラウザーで summer.games のページが開くので、サインインして Allow を選択してください。
その後、エージェントに何かを作るよう頼みましょう。
Claude Code:Summer プラグイン
Claude Code で次を入力します。
/plugin install summer --marketplace summerengine/summer
続いて /summer:start と入力します。ユーザーの OK を一度得るだけで、サインインなしに約 5 分で最初のゲームをプレイできるようにします。すでにプレイ可能なテンプレートから始めることも、アイデアに合わせて Summer がチャット内で描くコンセプトアートをもとに計画を立てることもでき、Summer Engine のデスクトップアプリで構築されます。このプラグインには、Summer のスキルと 2 つの MCP サーバーが含まれています。summer-engine はデスクトップアプリを操作し(Node が必要です)、summer-cloud は Summer のホスト型サーバーです(/mcp で一度サインインしてください)。同じスキルがインストールされるため、プラグインと summer setup claude-code のどちらか一方だけを使ってください。
アセットだけが必要ですか?
効果音、音楽、音声、画像、3D モデル、モーション、動画は Summer のサーバー上で作成されるため、これらを使うのに Summer Engine アプリは必要ありません。最も手軽なのは、Connect にあるホスト型サーバーを使う方法です。Node もインストールも不要です。アセットスキルも取得するには、代わりに次の内容を貼り付けます。
このエージェントを Summer に接続して、ゲームアセットを作成できるようにしてください。github.com/summerengine/summer を読み、自分で Summer に接続して、私をログインさせてください。Summer Engine アプリとスタータープロジェクトは不要です。アセットだけが必要です。
エージェントはアセットスキルと MCP 設定(summer-engine 4.0.0 以降)をインストールし、あなたをサインインさせます。エンジンはダウンロードしません。各アセットは通常のファイルとして Summer ライブラリに保存されます。3D モデルは GLB、画像は PNG、JPG、WebP、オーディオは MP3、WAV、動画は MP4 です。エージェントは各ファイルをプロジェクト内(エンジンのアセットフォルダー、または指定したフォルダー)に保存するため、どのエンジンや Web アプリでも利用できます。
これを読むエージェント向け:インストール手順
エージェントが実行するインストール手順(人間はスキップできます)
あなたは AI コーディングエージェントです。ユーザーから Summer Engine のインストールを依頼されました。シェルからこの手順を実行してください:macOS/Linux では Bash、Windows では PowerShell を使います。まず検出し、不足しているものだけをインストールします。(インストール後は、作業ガイド AGENTS.md に従ってください。)
アセットのみの場合。 ユーザーが Summer Engine で作るゲームではなく、アセット(効果音、音楽、音声、画像、3D モデル、動画)だけを必要としている場合、またはエンジンをスキップするよう指示された場合は、Step -1、Step 0、--assets-only を追加した Step 1、Step 3 を実行し、その後インストールを終了してください。--assets-only は assets ツールプロファイル(生成ツールとアセットツールのみで、エンジンツールは含みません)を書き込み、アセットスキルのみをインストールし、Summer Games を除外します(友人とプレイするためのもので、除外するとサインインを省けます)。Step 2(エンジンのダウンロード)、Step 5、Step 6 はスキップしてください。この手順では、engine-install と local-api に関する doctor の警告は想定どおりなので、そのままにしてください。アセット操作(assets.generate_audio、assets.generate_sfx_choices、assets.generate_image、assets.generate_3d、assets.generate_video、assets.search)は Summer のサーバー上で実行され、ログインだけが必要です。ほとんどのエージェントは、再起動後にのみ新しい MCP サーバーを読み込みます。それまでは、同じ操作をシェルから実行してください:npx -y summer-engine@latest <area> <action> --<field> <value>(summer ops search <words> で操作とその入力を検索できます)。たとえば、ユーザーが選べるように1つの効果音を3種類作成するには、次を実行します:npx -y summer-engine@latest assets generate-sfx-choices --text "sword clash"。各アセットはユーザーの Summer ライブラリに保存されます。呼び出しで out(フォルダーまたはファイルパス)を指定すると、このマシンに保存され、応答に localPath が含まれます。また、assets.get は Summer Engine の外部で使うための downloadUrl を返します。
Windows PowerShell:この手順で npx と書かれている箇所では npx.cmd を入力してください。 PowerShell で通常の npx を実行すると npx.ps1 が動きますが、Windows では既定でブロックされます(「このシステムではスクリプトの実行が無効になっています」)。npx.cmd はこのブロックを受けない同じコマンドです。回避のために実行ポリシーを変更したり、Windows Defender を無効にしたりしないでください。Windows 上の Git Bash を含む Bash では、通常の npx を使用できます。
Step -1:Node.js が PATH 上にあることを確認する
node --version
Node.js 20 以降が表示された場合は、Step 0 に進みます。
Windows で Node がない、または20より古い場合: クリーンな Windows マシンには Node がなく、CLI と MCP サーバー全体が Node を介して動作します。ユーザーに一度だけ尋ねてください:「Summer には Node.js が必要です。winget で LTS バージョンをインストールしてもよろしいですか?」承諾された場合は、次を実行します:
winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')
node --version
2行目は、新しい Node を再起動せずにこのシェルで認識できるようにします。Windows で管理者プロンプトが表示されることがあります。ユーザーに承諾するよう伝えてください。その後、同じシェルでこの手順を続けます。セットアップが完了したら、ユーザーに次のように伝えてください:「Node を認識させるため、 を一度再起動してください。その後、Summer MCP が接続されます。」Node のインストール時にすでに起動していたアプリは、再起動するまで MCP サーバーを起動できません。winget が利用できない場合は、ユーザーに次のように伝えて停止してください:「https://nodejs.org から Node.js LTS をインストールし、このアプリを再起動してから、プロンプトをもう一度実行してください。」
macOS/Linux で Node がない、または20より古い場合: 停止し、ユーザーに次のように伝えてください:「Summer には Node.js 20 以降が必要です。https://nodejs.org からインストールして、プロンプトをもう一度実行してください。」
ステップ 0:インストール状況を確認する(読み取り専用)
npx -y summer-engine@latest doctor --json
最初の呼び出しでは、パッケージが npx のキャッシュにダウンロードされます(約 2 MB、数秒)。以降の呼び出しは高速です。-y は npx の「summer-engine をインストールしてもよいですか?」というプロンプトに応答し、非対話型のシェルで呼び出しが停止しないようにします。
JSON 出力を読み取ってください。トップレベルの ok: true は「失敗したチェックがない」という意味であり、Summer がインストール済みという意味ではありません。 スキル、MCP 設定、ログインが何もないマシンでも、それらのチェックは失敗ではなく警告となるため、ok: true が返されることがあります。そのため、ok の場合もステップ 1 を省略しないでください。ステップ 1 は冪等で高速です。checks 配列(各項目には id、label、ok / warning / fail のいずれかの status、message、省略可能な details が含まれます)は、時間のかかるステップ(エンジンのダウンロード(ステップ 2)とブラウザーでのログイン(ステップ 3))が必要かどうかの判断にのみ使用してください。ビルドにログインは不要です。ステップ 3 はクラウド作業にのみ必要です。
チェック ID は node-version、cli-version、cli-version-current、skills-version-stale、login、store-access、engine-install、local-api、project-memory、mcp-boot、mcp-tools-list です。status が ok 以外のチェックがあれば、以下の表のアクションを実行してから、doctor を再実行してください。
| チェック ID | status が ok の場合 | 対応が必要な場合のアクション |
|---|---|---|
node-version | 続行する | ステップ -1 で確認済みです |
cli-version | npx 経由で常に ok | 対応不要 |
cli-version-current | 続行する | npx clear-npx-cache && npx -y summer-engine@latest doctor --json を実行する(新たに解決し直します) |
skills-version-stale | ステップ 1 をそのまま実行する(冪等) | ステップ 1 を実行する(コマンドに --force がすでに含まれています) |
login | ステップ 3 を省略する | ビルドにログインは不要です。クラウド作業(アセット、公開)の場合、またはツールが not_signed_in を返す場合にのみ、ステップ 3 を実行します |
store-access | 続行する | 公開する場合のみ:message を提示します(ストア独自の理由が記載されています)。ストアが有効なサインインを拒否した場合、再ログインしても解決しません |
engine-install | ステップ 2 を省略する | ステップ 5(summer dev)でインストールします |
local-api | ステップ 5b の待機ループを省略する | ステップ 5 の前はこの状態が想定されます。summer dev が待機します |
project-memory | 続行する | プロジェクトを開いている場合は、ビルド前に brainstorm-game スキルを使用します |
mcp-boot | 続行する | MCP サーバーのローカルでの起動に失敗しました。message をユーザーに提示します |
mcp-tools-list | 続行する | MCP サーバーは起動しましたが、ツールが一覧にありません。message をユーザーに提示します。通常は npx キャッシュが古いためです(npx clear-npx-cache) |
バージョンにずれがある場合: cli-version-current または skills-version-stale のいずれかで対応が必要な場合は、先に更新してください。ユーザーには一度だけ、「新しい Summer があります(X.Y.Z から A.B.C)。開始前に更新します。」と伝えます。次に、そのチェックの details.recommendedAction に記載されたコマンド(新しい npx clear-npx-cache && npx -y summer-engine@latest ...)を実行してから、doctor を再実行してください。ユーザーに選択を求めないでください。ユーザーは「install」と入力し、最新版を求めています。
ステップ 1:スキルと MCP の設定をインストールする(必ず実行してください。冪等で高速です)
npx -y summer-engine@latest setup claude-code --yes --force
claude-code を、ユーザーが実際に使用しているエージェントに置き換えます。claude-desktop、codex、cursor、windsurf、antigravity、cline、cline-cli、kilo-code、github-copilot、vscode-copilot、visual-studio、copilot-jetbrains、opencode、zed、kiro、goose、hermes、trae、qwen-code、kimi-code、crush、amp、factory、junie、warp、rovo-dev、qoder、grok-build、mistral-vibe、lm-studio が指定できます。Copilot CLI には github-copilot、VS Code の GitHub Copilot Chat/Agent には vscode-copilot、Visual Studio の Copilot には visual-studio、JetBrains IDE の Copilot には copilot-jetbrains を使用します。レガシーのターゲットである gemini と roo-code も引き続き使用できます。Google のエージェントには antigravity を使用してください。これにより、ライブラリ内のすべてのスキルが ~/.claude/skills/<slug>/SKILL.md(またはエージェント固有のスキルディレクトリ)にインストールされ、MCP サーバーの設定が書き込まれ、doctor が実行され、インストールしたスキルとその保存先が表示されます。プレビュー版のスキルも含まれ、プレビュー版であることが明記されます。--stable-only を指定すると、プレビュー版は除外されます。--force を指定すると、古いスキルのコピーが最初に削除されます。この手順では --recommended を使用しないでください。インストールされるのは一部のスキルのみです。
Summer Games: サインインに summer.games を利用できるすべてのエージェント(claude-desktop、visual-studio、qoder、rovo-dev、lm-studio、およびレガシーのターゲットを除く)では、セットアップ時にリモートの summer-games MCP(https://mcp.summer.games/mcp)も追加され、Sign in once: の行が表示されます。その行を、ユーザーに一度だけ分かりやすく伝えてください。ブラウザーで summer.games が開くので、サインインして「許可」を選択します。完了を待たずに、この手順を続けてください。ユーザーが同じ URL を別の名前(例:summer)ですでに追加している場合、セットアップではその設定が維持され、2つ目のエントリは追加されません。
初回インストールの判定: このコマンドの実行前に ~/.claude/skills/ が存在しなかった場合、Claude Code はそのディレクトリを監視していないため、このセッションでは新しいファイルを自動検出しません。ユーザーに 一度だけ 次のように伝えてください:「スキルをインストールしました。読み込むにはエージェントを再起動してください。」2回目以降のインストールでは(ディレクトリがすでに存在する場合)、スキルはセッション中に自動検出されるため、再起動は不要です。ステップ 1 を実行する前に ~/.claude/skills/ が存在していたかを確認すると、初回インストールかアップグレードかを判定できます。その結果を記録してからセットアップを実行してください。
/plugin install やその他のスラッシュコマンドは実行しないでください。 エージェントはそれらを入力できません。この手順では CLI を使ってインストールします。Claude Code のプラグイン(上記)は、ユーザー自身が選ぶワンステップの方法です。ユーザーがすでにプラグインをインストールしている場合は、ステップ 1 を省略してください。プラグインと summer setup は同じスキルをインストールします。
ステップ 2:エンジンアプリをインストールする(ステップ 5 で実行します)
ステップ 5 の summer dev は、エンジンがない場合にインストールします。ここで実行するコマンドはありません。プロジェクトを作成せずにインストールする場合のみ:
npx -y summer-engine@latest install
Summer の署名付きリリースから、Git などのランタイムツールを含めて約 660 MB をダウンロードします。CLI は書き込みを開始する前にサイズを表示します。ユーザーが停止したと思って中断しないよう、**「エンジンアプリをダウンロードしています。約 660 MB で、数分かかります」**と伝えてください。失敗した場合は、理由(download、checksum、disk_space、mount、copy、permission、app_running、needs_confirmation)と次に行う手順が1つ表示されます。
すでにインストール済みの場合: summer install がエンジンを無言で置き換えることはありません。同じバージョンの場合は「up to date」として終了コード 0 で終了します。異なるバージョンは --yes または TTY での確認がある場合にのみ置き換えられます。また、新しいバンドルはコピーが完全に終わってから切り替えられるため、ダウンロードに失敗しても古いエンジンはそのまま残ります。
Linux に関する注意: Linux(x86_64)では、summer install によりエンジンのバイナリが ~/.summer/engine/ に配置されます(または --path でローカルビルドへのシンボリックリンクが作成されます)。デスクトップアプリのバンドルはありません。エディターはそのバイナリから起動します。その他のアーキテクチャの場合は、ユーザーに https://summerengine.com/download を案内して終了してください。
ステップ 3:サインインする(クラウド機能を使う場合のみ)
エンジンツールにサインインは不要なので、そのためにビルドを止めないでください。ユーザーが Summer のクラウド(アセット、プラン、公開)を使いたい場合、またはツールが not_signed_in を返す場合に実行します。
npx -y summer-engine@latest login
ユーザーのデフォルトブラウザーが開き、すべての Summer ツールで使えるサインインが一度だけ行われます。まず Summer アカウントにサインインし(「Yes, Sign In」)、次に同じブラウザーでストア、公開、Grow ツール用の「Welcome to Summer CLI」ページが開きます(「Allow」を一度クリックします。このマシンが以前に承認されている場合は不要です)。ユーザーに次のように伝えてください:「ブラウザーが開きます。サインインして『Yes, Sign In』をクリックし、次のページで『Allow』をクリックしたら、このターミナルに戻ってください。」CLI は返された ID を確認し、エンジンと共有されるセッションを ~/.summer/ に保存します。ストアの手順が 3 分以内に完了しない場合でも、アカウントのサインイン情報は保存されています。後から summer login --store を実行してストアを追加できます。繰り返し実行しないでください。
ステップ 4:doctor を再実行して確認する
npx -y summer-engine@latest doctor --json
cli-version、mcp-boot、mcp-tools-list は、status: "ok" になっているはずです(ステップ 3 を実行した場合は、login も同様です)。engine-install と local-api は、ステップ 5 まで対応が必要な場合があります。セットアップチェックにまだ対応が必要な場合は、該当する message をそのままユーザーに伝え、繰り返し実行したり問題を取り繕ったりしないでください。
ステップ 5:1 つのコマンドでインストール、作成、起動する
重要: summer dev は現在の作業ディレクトリで動作します。最初に、ユーザーのホームディレクトリや Projects フォルダーなど、安定した親ディレクトリを選び、そこに cd してください。一時ディレクトリや、エージェントがたまたま開始したディレクトリで実行しないでください。
cd ~/Projects # or wherever the user keeps code
ユーザーがテンプレートを指定せずに「ゲームを作ろう」と言った場合は、デフォルト(3d-basic:空、柔らかな影のある太陽、地面、カメラに映る主人公)を使います。ユーザーの依頼から適切なプロジェクト名を選んでください。たとえば「FPS」なら my-fps-game にします。名前にスペースは使わないでください。
npx -y summer-engine@latest dev --yes 3d-basic my-fps-game
--yes は、エンジンがない場合にインストールすることへのユーザーの同意を示します(約 660 MB)。まずユーザーに確認してください。これを指定しない場合、summer dev は何もインストールせず、質問事項とともに needs_confirmation を返して終了します。エンジンがない場合はインストールし、プロジェクトを作成します(すでに project.godot があるフォルダーは、そのまま開きます)。エディターをバックグラウンドで起動し、ローカル API が利用可能になるまで最大 3 分待ちます。10 秒ごとに進捗を表示し、最後に Connected: の行を 1 つ出力します。初回はダウンロードが先に行われるため、シェル呼び出しのタイムアウトを長め(10 分)に設定してください。summer dev . は、空の場合に現在のフォルダーを使います。
ステップ 5b:エンジンに接続できるようになるまで待つ(summer dev が起動中と表示した場合のみ)
初回起動時はすべてのアセットをインポートするため、待ち時間を超えることがあります。ツールの実行に必要な場合、MCP もプロジェクトを自動的に開きます。シェルから待つには、次のようにします。
doctor --json は整形表示され(1 行につき "id"、"label"、"status" などのフィールドが 1 つずつ表示される)ため、複数行にまたがって照合します。
# Poll doctor until local-api flips to ok (max ~30s):
for i in 1 2 3 4 5 6; do
npx -y summer-engine@latest doctor --json | grep -A2 '"id": "local-api"' | grep -q '"status": "ok"' && break
sleep 5
done
(同等の PowerShell コマンド:for ($i = 0; $i -lt 6; $i++) { $r = (npx -y summer-engine@latest doctor --json) -join "n"; if ($r -match '"id": "local-api",\s*"label": "[^"]",\s"status": "ok"') { break }; Start-Sleep 5 }`)
local-api が ok になれば、MCP ツールを安全に呼び出せます。
ステップ 6:ゲームのアイデアを練り、その後に構築する
スキルと MCP が使えるようになりました。曖昧なプロンプトから、すぐに summer create のコンテンツを作り始めないでください。まずタスクを計画します。summer_call に {"op": "docs.plan", "input": {"goal": "<the user's goal>"}} を指定して呼び出します(シェルから実行する場合は summer plan <goal>)。その後、推奨されたスキルを呼び出します。「ゲームを作って」のような曖昧な依頼では、通常は brainstorm-game スキルを使います(インストール済みのスキルは、プレフィックスに summer: を付けず、スラッグ名だけで呼び出します)。このスキルはゲームの仕組み、アートディレクション、V1 の対象範囲を明確にし、結果を .summer/GameSoul.md に書き込みます。ほかのすべての Summer スキルは、このファイルを参照します。
プロジェクトのメモリは .summer/ 内に、読みやすい Markdown 形式で保存されます。キャラクターの声の ID、世界観の正史、プロバイダーとのバインディングなど、セッション間で変わらないようにする確定事項には .summer/memory/ を使います。ユーザーは summer memory で内容を確認できます。エージェントは、創作、音声、会話、レベル、キャラクターに関する作業を変更する前に、summer_get_project_context で提示された関連メモリを読んでください。
ブレインストーミングを省略できるのは、ユーザーが「ブレインストーミングを省略して」または「とにかく今すぐ X を作って」と明示した場合だけです。ブレインストーミングの後は、適切な構築スキル(fps-controller、design-mechanic、design-level、make-game など)が自然言語から自動的に起動します。
アンチパターン(次のことはしないでください)
npm install -g summer-engineは実行しないでください。 代わりにnpx -y summer-engine@latest ...を使用してください。ほとんどの Mac/Linux 環境では-gにsudoが必要なため、ユーザーに権限エラーが発生し、作業が行き詰まります。npxは root 権限なしで動作し、同梱の MCP 設定もすでにnpx summer-engine mcpを指定しています。- ユーザーに確認せず Node.js をインストールしないでください。また、インストールには winget 以外を使わないでください。 Windows では、Step -1 でユーザーの許可を得た後、winget を使って Node LTS をインストールします。macOS/Linux では https://nodejs.org を案内し、そこで止めてください。
- Windows PowerShell で通常の
npxを実行しないでください。また、動作させるために実行ポリシーや Defender を変更しないでください。npx.cmdを使用してください。 - ユーザーに「エンジンも必要ですか?」や「CLI も必要ですか?」と尋ねないでください。 このプレイブックではすべてをインストールします。例外はアセットのみを求められた場合です(このプレイブック冒頭の アセットのみ を参照)。
- 二重にダウンロードしないでください。 必ず最初に
npx -y summer-engine@latest doctor --jsonを実行してください。summer devはエンジンがすでにインストールされている場合、ダウンロードをスキップします。例外は Step 1(setup)です。これは冪等なので毎回実行してください。doctor のトップレベルにあるokでは、スキルや MCP 設定がインストールされているかどうかを判定できません。 summer installやsummer loginをバックグラウンドで実行しないでください。 ユーザー向けの出力(エンジンのダウンロード状況、ブラウザーを開く通知)が表示されます。ユーザーに状況が見えるよう、フォアグラウンドで実行してください。summer doctorの--jsonフラグを省略しないでください。 テキスト出力は解析が不安定で、バージョンごとに変わります。npxの-yフラグを省略しないでください。 指定しないと npx が対話形式で「ok to install summer-engine?」と確認し、非対話型シェルでは呼び出しが停止します。- npx コマンドから
@latestを省略しないでください。 バージョンを指定しないnpx -y summer-engineは、npx のローカルキャッシュにあるものを使うため、古いバージョンの可能性があります。@latestタグを付けると、npm がレジストリから再解決します。ユーザーから「unknown command 'doctor'」と報告された場合や、スキルの一覧が想定より大幅に少ない場合は、キャッシュが使われています。npx clear-npx-cacheを実行してから、@latestを付けて再試行するよう案内してください。 - サインインのためにビルドを停止しないでください。 エンジンのツールはサインアウト状態でも動作します。クラウド操作で
not_signed_inが返された場合にのみ、サインインしてください。 - 先に安定した親ディレクトリへ
cdせずにsummer devやsummer createを実行しないでください。 これらのコマンドは CWD に書き込みます。一時ディレクトリから開始したエージェントは、プロジェクトをそこに作成してしまいます。 - タイムアウトしても
summer loginを繰り返さないでください。 アカウントへのサインインを最大15分間待機します。もう一度だけ実行し、開いたブラウザータブでユーザーが「Yes, Sign In」を完了するよう伝えてください。延々と繰り返すと、ユーザーが先へ進めなくなります。 - 曖昧なプロンプトから、いきなり
summer createを実行しないでください。 まずbrainstorm-gameスキルを呼び出してください(Step 6)。ビルドスキルは.summer/GameSoul.mdが存在することを前提としています。
別のエージェントを使っていますか? Step 1 の ID を使用してください(devin、agy、droid などのエイリアスも使用できます。 CLI reference を参照)。スキルフォルダーはエージェントごとに異なりますが、CLI が違いを処理します。また、integrations/README.md には、各クライアントでどこに何が書き込まれるかが正確に記載されています。インストール後、Cline ユーザーは VS Code を再起動して、拡張機能の MCP 設定を再読み込みしてください。VS Code Copilot ユーザーは、VS Code が MCP サーバーを自動起動しない場合、Agent モードから summer-engine MCP サーバーを起動してください。
普段のターミナル操作で summer を PATH に追加したい場合は、npm のグローバルインストールも使用できます。エージェントのフローでは不要です。
ライフサイクル:作成 → テスト → 公開 → 成長
| 段階 | 状態 | 現在の内容 |
|---|---|---|
| 作成 | 利用可能 | 固定されたテンプレートからひな形を作成し、MCP を通じてシーンやスクリプトを構築し、ライブラリのガイドを受けながら 2D/3D/音声/動画アセットを生成します。 |
| テスト | 利用可能 | 検証の段階的な手順です。コンパイルチェック、スクリーンショット、デバッガーによる読み取りを伴う実プレイ、そして実際のキーを押して実際のフレームを検証する入力駆動のプローブ(RunVerification)を行います。 |
| 公開 | 利用可能 | summer_export_game はインストール済みエンジンでストア用ファイルをビルドします。store.upload_file は、ゲーム、ファイル、バージョンを正確に確認した後にアップロードします。store.update_listing、store.set_art、store.set_trailer はストアページ(テキスト、タグ、長文の説明、サポート連絡先、リリース日、アート、トレーラー)を書き込みます。store.preview_link は非公開のプレビューリンクを作成します。store.publish はゲームを Summer のストア審査に提出します。store.status は審査状況とリリースを表示します。store.release は承認済みビルドをリリースします。公開スイッチがオフの場合、エージェントは最初に確認を求めます。 |
| 成長 | 利用可能 | analytics.overview と analytics.summary は、ストアページの閲覧数、起動数、プレイセッション数、プレイ時間、ゲーム独自のイベントを読み取ります(summer-analytics スキルを参照)。pricing.* は価格、国別価格、セールを設定します。experiments.* はストアページの A/B テストを実施します。games.members とメンバー操作は、ゲームに携わるメンバーを管理します。marketing.* は Summer の成長支援サービスに申し込みます。 |
これらはホストされた Summer サーバー上の操作です。summer login の後はローカルサーバーでも実行できます。
エージェントから Summer を呼び出す方法
すべての機能は <area>.<action> という名前の操作です。例:assets.generate_image、store.publish、pricing.set_base。
- 直接ツールは一般的な作業に対応します。操作名の先頭に
summer_を付け、.を_に置き換えます(games.listはsummer_games_listです)。エンジンツールは 3.x の名前(summer_add_node、summer_run_script、summer_play、summer_screenshot)を維持し、メーカーはsummer_tool_<slug>を維持します。 - その他すべて:
summer_searchは、言葉で説明した作業に対応する操作を検索し、正確な入力を返します。summer_callは操作を実行します:{op, input, dryRun?, idempotencyKey?}。 - 応答形式は共通です。
resultを伴うdone、ジョブを伴うrunning(summer_jobs_waitは呼び出しごとに最大 50 秒待機します)、リンクを伴うneeds_approval、プレビューを伴うdry_run、またはcode、message、次の手順を 1 つだけ含むエラーです。 - 安全に試せます:変更を伴う操作にはすべて
dryRun: trueを指定できます(変更も消費も発生しません。消費がある場合は、あなた自身のクレジット見積もりが表示されます)。また、idempotencyKeyを指定できるため、再試行しても二重実行されません。 - エラーコード:
invalid_input、not_signed_in、forbidden、not_found、conflict、idempotency_conflict、in_progress、rate_limited、no_credits、over_limit、engine_not_running、engine_lacks_op、unsupported、not_in_profile、moved、outcome_unknown、unavailable、internal。 - 3.x の名前は 4.x でも引き続き使用できます:
summer_callはすべてのサーバーでそれらの名前を受け付けます。summer mcp --toolsets legacyはローカルサーバーでそれらを一覧表示します。また、インストール済みのスキルが 4.0 より古い間は、ローカルサーバーが自動的にそれらを一覧表示します。アップグレード後の初回起動時に、インストール済みの Summer スキルが更新されるため、アップグレード後は、要求しない限りレガシー一覧は表示されません。旧名と操作名の対応表はregistry/operations/legacy-names.jsonにあります。
同じ操作はシェルからも実行できます:summer <area> <action> --<field> <value>(例:summer assets generate-image --prompt "a cozy pixel-art tavern" --aspect-ratio 16:9)。--dry-run、--wait(ジョブまたは承認の完了まで追跡)、--json(応答のみを出力し、ok の応答なら終了コード 0、エラーなら 1)を指定できます。summer whoami はサインイン中のユーザーを表示します。summer ops search <words> と summer ops describe <op> は操作とその入力を検索します。読み取りを行うすべてのコマンドでは --json を指定できます。
このリポジトリの内容
summer/
├── README.md # you are here: overview + the install playbook
├── AGENTS.md # the agent guide: trust, the library, navigation, engine rules
├── src/ # the Summer software (TypeScript)
│ ├── core/ # shared implementations (capabilities used by both CLI and MCP)
│ ├── cli/ # the `summer` command surface
│ ├── mcp/ # the MCP server and tool adapters
│ ├── project-memory/# .summer/ read/write
│ └── installer/ # agent detection and config writing for every supported client
├── library/ # the Library: tools, skills, templates, references
├── registry/ # schemas + generated/ (the compiled index everything reads; never hand-edited)
├── evals/ # evidence the library works: routing, skills, examples, templates, tools, end-to-end
├── integrations/ # one folder per supported agent: what gets installed where
├── commands/ # the shipped slash commands (/summer, /gameskill, the plugin's /summer:start)
├── hooks/ # lifecycle hooks: session-start orientation, opt-in pre-commit doctor
├── assets/ # files the tools ship with: offline API docs, engine-side probe and audit scripts
├── scripts/ # generate-registry (the compiler), validate-library (schema + capability lint)
├── tests/ # v2 prose behaviour specs (the code tests sit next to the code in src/)
├── docs/ # development guide, migration notes, design contract
└── .claude-plugin/ … # plugin manifests for Claude Code, Codex, Cursor and Factory (generated)
全体を貫くルールはひとつです。各エントリーは一度だけ記述します(library/ 内の resource.yaml)。レジストリコンパイラーが、検索可能なインデックス、各エージェントのプラグインマニフェスト、スキルインストーラーのデータ、件数、旧形式のエイリアスなど、残りすべてを生成します。差異があると CI は失敗します。詳しくは docs/design/CONTRACT.md をご覧ください。
ライブラリ
6 種類のエントリーがあり、すべて同じ生成済みインデックスから検索できます。
- スキル — 何かをうまく行う方法(FPS コントローラー、シーン構成、デバッグの手順、VFX のレシピ、オーディオの演出など)。オープンな Agent Skills 形式なので、準拠するツールならどれでも利用できます。
- サンプル — 必要な証拠(スクリーンショット、検証記録など)を備えた、実証済みの動作例です。動作を示せないサンプルは公開されません。
- テンプレート — 完成したプロジェクトのひな形(プラットフォーマー、FPS、レーシング、ローグライク、マルチプレイヤーのスターターなど)です。それぞれ、検証済みのツリーダイジェストを持つ正確なコミットに固定されています。
summer create <slug>はそのコミットを取得し、ダイジェストを再計算して、不一致があれば拒否したうえで、その固定情報をプロジェクトの.summer/project.jsonに記録します。ブランチに今日何が含まれているかに左右されることはありません。小規模なテンプレート3d-basicとemptyは組み込み済みで、オフラインで生成できます。summer list templatesで一覧を確認できます。固定ルールとダイジェストの計算式についてはlibrary/templates/README.mdをご覧ください。 - コレクション — スタイルルールやプリセットを備えた、厳選済みの互換性のあるクリエイティブ素材です。現在、公開されているものはありません。
- リファレンス — エンジンのバージョン互換性、GDScript のスタイル、ツールのリファレンスなどの事実情報です。
- ツール — 実行可能な機能そのものです。エージェントが実行できることを見つけられるよう、同じレジストリで記述されています。
エージェントはフォルダーを参照するのではなく、summer_docs_search(または summer tool search-library)を使って、要約、ユースケース、ファセットからコンパイル済みインデックス(registry/generated/index.json)を検索し、見つかった項目を summer_docs_read で読み込みます。ID は永続的なため、再編成後もフィードバックと証拠は各エントリーに紐付きます。
エコシステム
Claude Code · Codex · Cursor · Gemini · Copilot · OpenCode · …
│ (any AI coding agent)
▼
┌──────────────────────────────────────────────┐
│ Summer (this repo, npm: summer-engine) │
│ library · registry · MCP tools · CLI │
│ project memory (.summer/) · evals │
└──────────────────────────────────────────────┘
│ MCP / local API
▼
Summer Engine (desktop app: editor + runtime)
│
▼
summer.games store · your players
Summer はあらゆるエージェントで動作します。integrations/ は生成されたシステムをそれぞれのエージェントに適合させます。各項目がどこにインストールされるかは integrations/README.md をご覧ください。
プロジェクトのメモリ:.summer/
すべての Summer プロジェクトには、読みやすい Markdown と JSON 形式で独自のメモリが含まれます。
GameSoul.md— ブレインストーミング時に書かれ、すべてのビルドスキルで参照される、ゲームの約束です。memory/— 変わってはならない固定情報です。キャラクターの口調、世界設定の正史、プロバイダーのバインディングなどが含まれます。project.json— テンプレートの固定情報(id、version、repo+commit+tree_digest、またはbuiltin: true)、プロジェクトをひな形から作成したtoolkit_version、およびcreated_atが含まれます。どのテンプレートのどのコミットから、このプロジェクトが始まったのかを正確に記録します。
目的は、新しいエージェントなら、どのエージェントでも、どのセッションでも、元の会話がなくても、これはどんなゲームか、何が完了したか、何が検証済みか、次に何をするか に答えられるようにすることです。summer memory で自分で確認できます。
独自のスキルを追加する
独自の素材で Summer を拡張する方法は 2 つあります。
- 通常の方法でエージェントにスキルを追加する(
~/.claude/skills/、.cursor/rules/など)。Summer のスキルは標準の Agent Skills 形式なので、独自のスキルと共存できます。 - Summer に提供する(予定):外部の Summer 形式のリソースは、プロジェクト、ユーザー、またはスタジオ単位でインストールされ、
.summer/project.jsonに記録されます。これにより、プロジェクトに参加するすべてのエージェントが利用できます。スキーマ側の準備は整っています。外部エントリーは名前空間付き(<publisher>/<kind>/<slug>)で、公式 ID を暗黙に上書きすることはありません。インストーラーはまだ実装されていません。
公式エントリーは PR によってこのリポジトリに追加され、スキーマ検証と機能リンターによるチェックを受けます。
ライブラリへのフィードバック
- エージェントは、エントリーがどのように機能したかを報告できます(
summer_callのdocs.feedback):機能した/修正を加えて機能した/誤っていた/古くなっていた/不完全だった/適用されなかった/別の項目に振り分けられた。送信される情報のすべて:エントリー ID、それぞれに対応する結果を表す 1 語、任意のメモと相違点(エントリーに関するもので、最大 280 文字)、エンジンのバージョン、エージェントが自己申告するモデル ID、この CLI のバージョン、ホストアプリの名前とバージョン、プロセスごとにランダムに生成されるセッション ID、さらにログアウト中の場合に限りランダムなインストール UUID(ログイン中は、代わりにアカウントトークンが送信されます)。**スキーマにコード、ファイル、チャットを含めることはできません。**あるマシンでの最初の呼び出しでは何も送信されず、通知が表示されます。SUMMER_NO_TELEMETRY=1またはDO_NOT_TRACK=1を設定すると、テレメトリーを完全に無効にできます。 - 現在、これらのレポートは、メンテナーが確認する書き込み専用のメールボックスに届きます。検証済みの結果のみが評価対象となり、人気度によってエントリーの順位が決まることはありません。
テレメトリー
Summer は、どのエージェントアプリでどのツールやコマンドが機能しているかを把握するため、いくつかの利用状況を送信します。プロンプト、コード、ファイルの内容、ファイルパス、プロジェクト名、ツールの引数や結果、入力した内容は一切送信しません。SUMMER_NO_TELEMETRY=1 または DO_NOT_TRACK=1 を設定すると、すべて無効にできます。
コンピューターでの最初の summer コマンド(summer mcp など、どのコマンドでも)は、次の通知を一度だけ標準エラー出力に表示します。
Summer collects usage data to improve its tools: which commands and tools run, whether they worked, and which agent app ran them.
No prompts, code, file names or project names. Opt out: SUMMER_NO_TELEMETRY=1
Details: https://github.com/summerengine/summer#telemetry
すべての行は Summer サーバーの /api/mcp/log-local-call に送信されます。すべてのリクエストでは、ヘッダーにもこのパッケージのバージョンが含まれます。
| 行 | 送信タイミング | フィールド |
|---|---|---|
| 初回実行 | 通知とともに、コンピューターごとに一度。CI では送信されません。サインインなしで送信される唯一の行です。 | installId(~/.summer/feedback-install-id に保存されるランダムな ID。ライブラリへのフィードバックでも同じものを使用します。ハードウェア、ユーザー、プロジェクトの識別情報は含まれません)、command(dev などのコマンド名)、mcpClient(claude-code などのエージェントアプリ)、os(darwin、win32、linux のいずれか) |
| セッション | サインイン中:各 MCP サーバーの最初のツール呼び出し時 | mcpClient(MCP ハンドシェイクのホストアプリ名)、installId(初回実行の行をアカウントに関連付けるため) |
| ツール呼び出し | サインイン中:ローカルの MCP ツールを呼び出すたび | tool、op(Summer の操作)、ok、error(engine_not_running などの短いコード。メッセージは含まれません)、durationMs、mcpClient、surfaceVersion、profile、および該当する場合は以下のフィールド |
| コマンド | サインイン中(保存済みのサインイン情報または SUMMER_TOKEN):コンピューターで summer コマンドを実行するたび | tool(コマンド名または操作名)、op、ok、error、durationMs、mcpClient(環境から取得)、および該当する場合は以下のフィールド。summer login の後は installId も含まれます |
該当する場合、ツール呼び出しまたはコマンドに追加されるフィールド:
| フィールド | 例 | 内容 |
|---|---|---|
projectIdHash | 9f2c…e41a(64 桁の 16 進数文字列) | Summer Engine がすでにリクエストをプロジェクトに振り分けるために使用している ID:エンジンがプロジェクト内に保存するランダムな ID(.summer/local/.project_id)の sha256 です。名前やパスではありません。 |
templateId | 2d-platformer | プロジェクトの作成元となったライブラリテンプレート(.summer/project.json)。同梱カタログ内の ID のみです。 |
templateTags | ["2d", "platformer"] | summer create の場合のみ:そのテンプレートのライブラリドメインです。 |
instanceCount | 3 | engine.play の場合のみ:プレイ開始時のゲームクライアント数(通常の実行では 1、Local Play のプレイヤーと観戦者を含みます)。 |
engineState | {"desktopInstalled": true, "engineRunning": false, "projectOpen": false, "signedIn": true} | engine_not_running エラーの場合のみ:ローカルファイルから取得した 4 つのはい/いいえの情報です。 |
ライブラリへのフィードバック用メールボックスは別途用意されており、上記のとおりです。Summer のサーバー(生成、アセット、ストア)へのリクエストにも、ヘッダーにエージェントアプリ名、そのバージョン、ツールが含まれます。これらも同じ 2 つの環境変数で無効にできます。
ダウンロードされるもの
ディスクに手を加える前にお知らせします。
| 対象 | サイズ | タイミング | 提供元 |
|---|---|---|---|
summer-engine npm パッケージ(CLI + MCP + ライブラリ) | ダウンロード約 2 MB、展開後約 6 MB | 初回の npx -y summer-engine@latest ... 呼び出し時 | npmjs.com/package/summer-engine |
| Summer Engine アプリ | ダウンロード約 660 MB(エンジン + 同梱の Git/ランタイムツール) | npx -y summer-engine@latest dev または install の実行時。まだインストールされていない場合 | Summer の署名済みリリース |
| 認証トークン | 約 1 KB | npx -y summer-engine@latest login の実行時 | ブラウザーから ~/.summer/auth-token へ |
| ストアへのサインイン | 約 2 KB | summer login(アカウントへのサインイン直後)、または単独で summer login --store を実行した場合 | ブラウザー OAuth(PKCE、ループバックポート 47615-47617)から、リフレッシュトークンとともに ~/.summer/oauth-token へ。また、このマシンの公開クライアント ID は ~/.summer/oauth-client に保存されます。認証トークンが置き換えられることはありません |
| スキルファイル | 小容量、同梱 | npm パッケージ内 | 追加のネットワーク呼び出しなし |
| 生成アセット(3D/画像/音声/動画) | 変動します | 明示的に assets.generate_* を呼び出した場合のみ | Summer Engine Studio |
| URL インポート | 変動します | 明示的に summer_import_from_url を呼び出した場合のみ | 指定した URL |
ダウンロードも収集もされないもの:
- テレメトリに記載されているものを除き、テレメトリはありません。診断情報はローカルに保持されます。
- エンジンが気付かないうちに更新されることはありません。
summer installはインストール済みのバージョンを確認し、置き換える前に確認を求めます(または--yesが必要です)。エンジンが勝手に更新されることはありません。 - モデルの重みはダウンロードされません。AI 生成は Summer Engine Studio(クラウド)で実行され、マシン上で実行されることはありません。
オープンなものとそうでないもの
| 対象 | ライセンス | ソース |
|---|---|---|
| Summer(このリポジトリ:CLI、MCP サーバー、ライブラリ、統合機能) | MIT | summerengine/summer |
| Summer Engine アプリ(デスクトップエディターとランタイム) | 無料でダウンロード可能。現時点ではソース非公開 | summerengine.com/download |
| Summer のホスト型サービス(ストア、公開、Grow、マルチプレイヤーのホスティング、AI 生成) | Summer アカウントで利用 | summerengine.com/pricing |
summer.games への公開、マルチプレイヤーのホスティング、マッチメイキング、Grow は利用可能です。
CLI リファレンス
| コマンド | 説明 |
|---|---|
summer dev [template] [dir] | 何もない状態から、エージェントが操作できるエディターまでをワンステップで実行します。Summer Engine がない場合はインストールし、プロジェクトを作成します(テンプレートを指定しない場合は 3d-basic、空のフォルダーで . またはフォルダーを省略した場合は現在のフォルダーを使用します)。プロジェクトを開き、応答するまで待機します。project.godot があるフォルダーは開くだけです。 |
summer install [--yes] | Summer Engine をダウンロードします。最初に URL とサイズを表示します。確認なしにインストール済みのエンジンを置き換えることはありません。 |
summer login | すべての Summer ツールで使えるブラウザーサインインを一度行います。Summer アカウントに続いて、同じブラウザーでストア、公開、Grow の操作も行えます。--no-store を指定すると、ストアの手順を省略します。 |
summer login --store | ストアのサインインだけを行います(store.upload_file と、プラン、ストア、公開、Grow のクラウド操作)。 |
summer whoami | サインイン中のアカウント、そのプラン、クレジットを表示します。 |
summer <area> <action> [--<field> <value> …] [--input '<json>'] [--dry-run] [--idempotency-key <k>] [--wait] [--json] | シェルから任意の操作を実行します。たとえば、summer assets generate-image --prompt "…" や summer store status --game-id <id> を実行できます。 |
summer ops search <words…> / summer ops describe <op> | ジョブに対応する操作を検索するか、1 つの操作の入力、効果、承認要件を表示します。サインアウト中でも利用できます。クラウド操作には (needs sign-in) と表示されます。 |
summer logout | 認証トークンを消去します。 |
summer config [get|set|unset] | 共通の非機密設定ファイル ~/.summer/config.json を読み取るか、更新します。 |
summer status [--json] | エンジンの状態、ポート、認証情報を表示します。 |
summer doctor | Node、ログイン、エンジン、プロジェクトメモリー、MCP を診断します。 |
summer plan <goal> | ゲーム作成の目標を、スキル、MCP ツール、ゲート、検証に振り分けます。 |
summer memory | .summer 内のプロジェクトメモリーを確認します。 |
summer memory show <file> | プロジェクトメモリーの Markdown ファイルを表示します。 |
summer run [path] [--background|--focus] [--bin <executable>] | エンジンを起動します。TTY がないエージェントの場合、ウィンドウがフォーカスを奪わないよう、デフォルトではバックグラウンドで起動します。--focus を指定すると、ウィンドウを前面に表示します。--bin(環境変数 SUMMER_BIN)を指定すると、インストールされていないビルドを起動します。 |
summer open <path | target> [--print] [--list] | プロジェクトディレクトリーを実行中のエンジンで開きます。それ以外はナビゲーションターゲットとして扱われます。billing、my-games、mcp-guide、scene、inspector、意図を表すフレーズ、res:// パスなどをブラウザーで開くか、エディターに送信します。--print を指定すると、開かずに解決結果を表示します。 |
summer create <template> [name] | 固定されたテンプレートからプロジェクトのひな形を作成し、エージェント用の AGENTS.md(およびそれをインポートする CLAUDE.md)を追加します。 |
summer list templates / projects | 一覧を表示します。スクリプト用には --json を指定します。 |
summer events [--follow] [--kinds <csv>] [--since <seq>] [--json] | エンジンのイベントチャンネル(エンジン 0.5.66 以降)から、最新のイベントを取得するか、リアルタイムでストリーミングします。 |
summer debug [issue…] | サポートにそのまま渡せる Markdown 形式のデバッグレポートを作成します。 |
summer skills list | すべてのスキルを表示します(--by-domain を指定するとドメイン別に分類します。同じ分類は library/skills/README.md にもあります)。 |
summer skills install <name> | 1 つのスキルをインストールします。 |
summer skills install --all --agent <agent> / --recommended / --assets [--stable-only] | すべてのスキル(プレビューを含み、ラベルを付けて表示)、おすすめのスキルのみ、またはアセットスキルのみをインストールします。--stable-only を指定すると、プレビュー版のスキルを省略します。 |
summer tool <name> --args '<json>' | シェルから任意の Summer ツールを実行します。MCP ツールと同じ実装を使用します。summer tool --list を実行すると、すべてのツールを表示します。 |
summer mcp [--project <path> | --instance <id>] [--profile <p>] [--toolsets <list>] [--surface v4|v3] | MCP を起動します。通常はエージェントのプロジェクトディレクトリーから自動的にバインドされます。--surface(環境変数 SUMMER_SURFACE)には、v4(デフォルト。エンジンツール、summer_docs_search、summer_docs_read、summer_search、summer_call)または v3(3.x のツール)を指定します。--profile(環境変数 SUMMER_PROFILE)には、full(デフォルト。すべてのツール)、engine(エンジン、生成、ストアのツール。VS Code Copilot など、リクエストあたりのツール上限が 128 のクライアントに適しています)、assets(生成とアセットのツール。エンジンツールなし)を指定します。--toolsets(環境変数 SUMMER_TOOLSETS)には、名前でツールセットを追加します。core、assets、tools、engine、ui、ship、uploads、apps、board、grow、studio、cloud、projects(このコンピューター上でシェルを使わずにプロジェクトを作成して開きます。full の場合)、other、all を指定できます。--toolsets legacy を指定すると、すべての 3.x ツール名も一覧に表示されます。 |
summer mcp setup <agent> | 非推奨の summer setup <agent> エイリアスです。 |
summer setup <agent> [--yes] [--force] [--recommended] [--stable-only] [--no-games] [--profile <p>] [--assets-only] [--cli] | まとめて実行します。MCP 設定とすべてのスキル(プレビューを含みます。おすすめのスキルには --recommended、プレビューを省略するには --stable-only を指定します)を設定し、doctor を実行します。冪等です。--cli(または 4.2.0 以降の --no-mcp)を指定すると、スキルをインストールし、MCP サーバーはインストールしません。エージェントはシェルで summer コマンドを実行します。Summer プロジェクト内では、プロジェクトの AGENTS.md と CLAUDE.md にも Summer の指示を追加します。--no-project-files を指定すると、これを省略します。--profile を指定すると、エージェントの MCP エントリーにツールプロファイル(SUMMER_PROFILE)を書き込みます。vscode-copilot には、--profile full を指定しない限り engine が設定されます。それ以外のエージェントには、すべてのツールが設定されます。--assets-only はアセット用の設定です。assets プロファイル、アセットスキルのみを設定し、Summer Games は含めません。ほとんどのエージェント(Claude Desktop、Visual Studio、Qoder、Rovo Dev、LM Studio、旧式のターゲットを除く)では、同じ URL がすでに登録されていない限り、summer-games(https://mcp.summer.games/mcp。あなたとして友人、パーティー、メッセージを利用できます)も追加します。サインインは summer.games で一度行います。--no-games を指定すると、これを省略します。 |
エージェント:claude-code、claude-desktop、codex、cursor、windsurf、antigravity、cline、cline-cli、kilo-code、github-copilot、vscode-copilot、visual-studio、copilot-jetbrains、opencode、zed、kiro、goose、hermes、trae、qwen-code、kimi-code、crush、amp、factory、junie、warp、rovo-dev、qoder、grok-build、mistral-vibe、lm-studio。レガシー(引き続き受け付けますが、使用時に警告します):gemini、roo-code。エイリアス:devin/devin-desktop → windsurf、agy → antigravity、droid → factory、copilot → github-copilot、vscode → vscode-copilot、kilo → kilo-code、qwen → qwen-code、kimi → kimi-code。スコープ:--scope user(デフォルト)、--scope project。 |
貢献
ライブラリはPRによって拡充され、CIによって品質が保たれます。
- 問題のあるエントリーを報告する。 プロンプトと応答を引用してissueを作成してください。エージェントの場合は、失敗を確認した後に
summer_callを通じてdocs.feedbackを送信してください。 - エントリーを改善または追加する。
resource.yaml(スキルの場合はSKILL.mdも)を含むlibrary/<kind>/<slug>/を追加します。npm run validate:libraryを実行し、node scripts/generate-registry/cli.tsで再生成して、両方をコミットしてください。スキーマ、機能のlint、レジストリとの整合性はCIでチェックされます。
docs/DEVELOPMENT.mdは貢献者向けガイドです。ルールブックはdocs/design/CONTRACT.mdをご覧ください。
未公開ビルドを実際のエンジンとエージェントでエンドツーエンドにテストする方法については、docs/TESTING.mdをご覧ください。
ドキュメント
- エージェントガイド(AGENTS.md) — 検証の段階的な手順を含む、エージェントによるSummerの使用方法
- 開発ガイド · v2からv3への移行
- 設計:契約 · 決定事項
- エージェントのサポート一覧 · テンプレートの固定 · 評価
- ホスト別の情報:Claude Code · Codex · Cursor · OpenCode
ライセンス
このリポジトリ内のすべてはMITライセンスです。Summer Engine自体はプロプライエタリです。オープンなものとそうでないものをご覧ください。
一部のプロセススキル(ブレインストーミング、計画書の作成、スキルの作成、バグの調査)は、MITライセンスのobra/superpowersをベースにしています。クレジット表記はNOTICEに記載されています。
リンク
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。