1GP Publisher MCP

在 Codex、Claude Code 等支持 MCP 的客户端里检查并发布当前游戏到 https://1gp-game-platform.vercel.app 。每个用户使用自己的平台账号，一次浏览器授权后即可发布。无需平台管理员的 Vercel 或 Supabase Token。

安装

需要 Node.js 24+、npm（首次从 GitHub 安装 MCP 时需要 Git）。游戏本身不需要 Git 仓库。这是标准的 stdio MCP 服务，任何 MCP 客户端都能使用。

Codex

在 Codex 的 ~/.codex/config.toml 中添加：

[mcp_servers.onegp]
command = "npx"
args = ["--yes", "github:1gp-studio/publisher-mcp#v0.3.0"]
startup_timeout_sec = 60
tool_timeout_sec = 600

保存并重新打开 Codex 任务。首次运行 npx 会下载本项目及依赖，需要网络访问。

配置字段依据 Codex 官方配置文档。

Claude Code

在终端运行（--scope project 会写入当前游戏目录的 .mcp.json，只对这个项目生效；去掉则只对你本人生效）：

claude mcp add onegp --scope project -- npx --yes github:1gp-studio/publisher-mcp#v0.3.0

或直接在游戏目录创建 .mcp.json：

{
  "mcpServers": {
    "onegp": { "command": "npx", "args": ["--yes", "github:1gp-studio/publisher-mcp#v0.3.0"] }
  }
}

重新打开 Claude Code，首次使用项目级配置时确认启用该服务器。首次 npx 下载较慢，可用 MCP_TIMEOUT=60000 claude 启动以放宽启动超时。

本地源码

也可克隆此仓库，运行 npm ci --ignore-scripts，将 command 设置为 Node 可执行文件的绝对路径，args 设置为 src/server.js 的绝对路径。

Related MCP server: codex

使用

1. 告诉 AI（Codex / Claude Code）：连接 1GP 发布平台。调用 connect_platform 后，用户本人打开返回的授权链接，登录并点击允许。对照页面与工具的客户端指纹。

2. 打开游戏项目，告诉 AI：检查当前游戏，支持的话发布到 1GP，把试玩链接给我。

3. MCP 自动读取名字和介绍（Vite 项目读 package.json，Godot 项目读 project.godot）以及要上传的文件；未提供介绍时使用中性的默认介绍，不推断玩法。

4. publish_game 返回构建 ID；每隔至少 10 秒调用 get_publish_status，直到 ready 或 failed。只有 ready 表示发布成功。

通用静态网页发布

发布不要求 Vite。平台需要的是能直接由浏览器运行的静态网页目录，根目录含 index.html。支持四种流程：

例如 Webpack / Parcel / Astro 等项目可以使用其自身的静态输出；Next.js 必须先配置并生成静态导出，再选择 out，不能上传 .next 服务端目录。目录名称取决于项目配置，不会仅根据框架名称猜测。依赖服务端渲染、API 或数据库的项目需要自行托管后调用 publish_link。使用 pnpm、yarn 或其他构建工具时，可让本地 AI 工具先构建，再选择输出目录发布；MCP 内置脚本执行器只运行 npm 脚本。

已有产物：

{"project_directory":"/absolute/game","output_directory":"dist"}

先执行项目定义的脚本，再打包：

{"project_directory":"/absolute/game","build_script":"export:web","output_directory":"site"}

两组参数均可用于 inspect_game 和 publish_game。检查不执行脚本；已有产物会返回上传文件清单和大小。无法自动识别时返回 OUTPUT_REQUIRED 和可用脚本名称，由 AI 读取项目配置，选择正确输出，不需要迁移到 Vite。output_directory 必须是项目内的相对路径，不能经过符号链接；有构建脚本的项目禁止选择项目根目录。未构建的项目源码树不会作为兜底上传。

运行构建前需自行安装项目依赖。自定义脚本模式最多执行 5 分钟，必须生成或更新输出目录的 index.html，否则停止，不上传旧产物，也不删除已有输出。使用增量构建且入口未变时，可明确以已有产物模式发布。项目身份取决于项目根目录，切换输出目录不会另建游戏。

Godot 保留专用流程：读取 project.godot 和 Web 导出预设，上传本地单线程 Release 导出的 index.*，引擎 wasm 按哈希使用平台托管版本。MCP 不运行 Godot；导出早于源码时须先重新导出。目前支持 Godot 4.6.1-stable。引擎版本不受支持时可使用 publish_link。

网页产物限 3 MiB / 300 文件（Godot 不含引擎）。支持 HTML、JS、CSS、JSON、字体、图片、音视频、WASM、glTF、data/bin/atlas、XML 和 webmanifest。source map、隐藏文件、依赖及常见项目配置不上传；内联 source map、检测到的凭证或符号链接导致拒绝。更大游戏可自行托管产物再接入链接。平台直接部署，不安装依赖或执行构建。

浏览器 JavaScript 和资源会提供给平台及玩家。纯 HTML/JS 游戏的这些文件本身就是可发布代码，不能声称它们仍然私密。 不要将私密内容放入网页目录或通过构建复制进产物；过滤无法识别所有私密文件。只在你信任的项目上运行构建脚本。上传的是明确选择的网页目录，不是整个框架源码项目。

工具

需要指定输出时返回 OUTPUT_REQUIRED。错误包含 LOCAL_BUILD_FAILED、UNSUPPORTED_BUILD、POTENTIAL_SECRET、AUTH_REQUIRED，publish_link 另有 INVALID_URL、TITLE_REQUIRED；连不上平台时为 NETWORK_ERROR。遇到网络不确定的发布结果不要自动重复提交，可到网站「我的发布」查看。

授权与限制

本地凭证保存在 ~/.config/1gp-studio/，目录权限 0700，文件权限 0600。平台仅保存 SHA-256 哈希。凭证不会通过工具结果或浏览器 URL 输出。授权 90 天有效，仅允许发布和查询自己的构建；在网站「我的发布」撤销后，再运行 connect_platform 可重新连接。

平台目前限制全站同时 2 个构建、每个账号最多 50 个作品，不设每日次数限制。账号邮箱验证由 Supabase 负责；平台管理员必须配置生产邮件服务，才能支持组织外用户收取登录邮件。Vercel 的套餐、GitHub 访问授权及构建限制仍适用。

开发时可使用 ONEGP_PLATFORM_URL 指向另一 HTTPS 平台，或本机 HTTP localhost/127.0.0.1；凭证按平台分别保存。测试运行 npm test，包括真实 MCP stdio 客户端集成测试。

v0.3.0 发布顺序

先部署支持 web-static 的平台，再发布 MCP 的 v0.3.0 tag，最后更新客户端配置并重启。旧 v0.2.0 仍上传 Vite 源码；升级 MCP 才能使用本地构建。平台保留旧协议以兼容已有客户端。平台与 tag 发布前，请使用本地源码和测试平台验证。