mcpField
R
remix-mcp-quickstart

remix-mcp-quickstart

github.com/farworld-labs開発58 回インストール
リポジトリ

remix-mcp-quickstart について

remix-mcp-quickstartは、Remix MCPの認証設定と、ゲームの作成・更新・アップロードに使うツールや手順を案内するスキルです。Remixゲームを扱うエージェント向けで、既存IDの再利用と複数手順の前の関連リソース確認を重視します。

主な機能

  1. 01CLI認証とMCP設定
  2. 02ゲームとバージョンの管理ツール
  3. 03アセットとショップ項目の操作
  4. 04スキルリソースによる手順案内

活用シーン

  1. 01プロジェクトのRemix MCPアクセス設定
  2. 02Remixゲームの作成や更新
  3. 03ゲームコードとアセットのアップロード
  4. 04ゲーム内ショップ項目の管理

MCP 対応

Remix MCPサーバーの設定方法を説明します。サーバーはゲーム、アセット、ショップ操作のツールとスキルリソースをMCPクライアントに提供します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/farworld-labs/remix-skills --skill remix-mcp-quickstart

インストール後、Claude Code で/remix-mcp-quickstartを入力して読み込まれたか確認します。

詳細

インストールと認証

ブラウザー認証と再利用可能な認証情報が必要な場合は、ユーザー向け CLI をインストールしてください。

curl -fsSL https://remix.gg/install.sh | bash
remix login
remix whoami

次に、MCP を設定します。

claude mcp add remix-mcp -- npx -y @remix-gg/mcp

MCP サーバーは、次の順序で認証情報を読み込みます。

  1. REMIX_API_KEY
  2. ~/.config/remix/credentials.json に保存された CLI 認証情報

プロジェクト設定

現在パッケージ化されている MCP スキルでは、createGame を呼び出す前に次の順序で参照することを推奨しています。

  1. タスクのコンテキストまたは以前のツールの結果
  2. 最も近い .remix-cli.json
  3. レガシーの .remix-mcp.json

上流の MCP ドキュメントには、現在も一部に矛盾があり、.remix-settings.json に言及している場合があります。特定のプロジェクトですでに使用されている場合を除き、古いガイダンスとして扱ってください。安全なルールは、gameId と versionId がすでにある場合はそれらを再利用し、createGame を呼び出さないことです。

コアツールセット

  • createGame
  • updateGame
  • uploadVersion
  • generateImage
  • generateShopImage
  • uploadGameAsset
  • generateSpriteSheet
  • listShopItems
  • createShopItem
  • updateShopItem
  • deleteShopItem

スキルリソース

サーバーは skills://... 配下にスキルリソースを公開します。

  • skills://overview
  • skills://game-creation
  • skills://upload-game
  • skills://implement-multiplayer
  • skills://integrate-save-game
  • skills://add-image-to-game
  • skills://manage-shop-items
  • skills://add-sprite-to-game
  • skills://migrate-mobile-fullscreen
  • skills://open-game

複数の手順を伴う操作を行う前に、該当するスキルリソースを読み込んでください。

推奨フロー

  1. まずタスクのコンテキストを読み、次に .remix-cli.json、続いてレガシーの .remix-mcp.json を確認します。
  2. ID が存在しない場合は、createGame を呼び出します。
  3. window.RemixSDK の要件に沿ってゲームを作成または修正します。
  4. 必要に応じて、uploadGameAsset、generateImage、generateShopImage、または generateSpriteSheet でアセットをアップロードします。
  5. uploadVersion でコードをアップロードします。
  6. タスクに収益化が含まれる場合は、アイテムを作成または更新する前に listShopItems を実行します。
  7. 続行する前に、詳細なルールを確認するため、該当するワークフローリソースを使用します。

ガードレール

  • タスクのコンテキスト、.remix-cli.json、またはレガシーの .remix-mcp.json に ID がすでに記載されている場合は、createGame を呼び出さないでください。
  • ファイルパスを使う MCP ツールを呼び出す前に、HTML ファイルやアセットファイルを自分で読み込まないでください。
  • CLI ログインまたは REMIX_API_KEY を使用してください。MCP 専用の別の認証方式をでっち上げないでください。
  • パッケージのドキュメントに食い違いがある場合は、packages/mcp/src の現在のパッケージソースを優先してください。

コメント

Markdown 対応