mcpField
R
remix-mcp-quickstart

remix-mcp-quickstart

github.com/farworld-labs开发58 次安装
代码仓库

关于 remix-mcp-quickstart

remix-mcp-quickstart 是一份技能指南，介绍 Remix MCP 的认证配置，以及创建、更新和上传游戏的工具与流程，面向开发 Remix 游戏的 Agent。它强调优先复用项目已有 ID，并在多步操作前查阅对应资源。

主要功能

  1. 01CLI 认证与 MCP 配置
  2. 02游戏和版本管理工具
  3. 03资源与商店项目操作
  4. 04通过技能资源提供流程指南

适用场景

  1. 01为项目配置 Remix MCP 访问
  2. 02创建或更新 Remix 游戏
  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