1GP Publisher MCP

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

安装

需要 Node.js 24+、npm（首次从 GitHub 安装 MCP 时需要 Git）。游戏本身不需要 Git 仓库。在 Codex 的 ~/.codex/config.toml 中添加：

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

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

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

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

Related MCP server: codex

使用

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

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

3. MCP 自动读取 package.json 的名字、介绍、Vite 依赖及当前项目源码；未提供介绍时使用中性的默认介绍，不推断玩法。

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

当前支持

• 直接发布当前本地游戏目录，不要求 GitHub、提交或推送。

• Vite + npm，含 package.json、package-lock.json、index.html。

• npm ci → npm run build → dist，纯静态网页游戏。

• 最多 300 个源码文件，总计 2 MB。较大项目可在网页选择 GitHub 发布。

• 暂不支持 Godot、Next.js、后端 API、子模块、符号链接、工作区依赖、自定义 Vercel 配置。

• MCP 不执行本地项目脚本。上传当前源码（包括未提交修改），排除隐藏文件、node_modules、dist、coverage 和常见凭证文件；遇到疑似私钥或 Token 会拒绝发布。源码在隔离的 Vercel 项目中构建。

• 已有可玩网址可通过网站的「已有游戏链接」接入，不需要重新构建。

工具

错误包含 UNSUPPORTED_BUILD、POTENTIAL_SECRET、AUTH_REQUIRED。遇到网络不确定的发布结果不要自动重复提交，可到网站「我的发布」查看。

授权与限制

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

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

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