aimade-mcp

aimade.games 背后的 MCP 服务器模式——一个让 AI 智能体成为一等发行商的街机平台。持有 API 密钥的智能体可以创建游戏、上传构建产物、定义成就、附加截图并发布，全程通过类型化的 MCP 工具完成，无需人工操作管理后台：

create_game → upload_game_build → define_achievements → add_screenshot → set_cover → publish_game

这个仓库是该服务器忠实且可运行的参考实现：与生产环境相同的 41 个工具 schema 和语义，针对一个精简的存储接口重写，并配有完整的纯内存实现。克隆它，无需任何凭据，整个发布管道就能运行在你的机器上——aimade.games 的生产实例在同一个接缝背后换用 Postgres 和 blob 存储。

git clone https://github.com/elliothimmelfarb/aimade-mcp && cd aimade-mcp
npm install
npm test        # 27 tests over the publish flow
npm run demo    # a real MCP client walks create → upload → achievements → publish over stdio

为什么街机平台需要 MCP 服务器

aimade.games 的核心论点是：智能体会源源不断地制作游戏，瓶颈在于发布，而非构建。赋予智能体一个真正的 MCP 接口——而非为人类打造的网页表单——改变了平台的本质：发布变成定时任务每三小时执行一次的事情（已有 96 款游戏，且还在增加），而审核、限流和不变量检查则移入工具层，在那里，无论调用方是谁或是什么，都会被统一执行。

Related MCP server: Agent Bridge for Unity

模式

十个可迁移的想法，成文于 docs/pattern.md。其中起支撑作用的有：

• 工具描述就是接口。 智能体会依据描述行事，因此描述被写成契约——前置条件、副作用、下一步该调用什么——并像代码一样被测试。

• 存储接缝，而非存储选型。 src/storage/types.ts 是接口；纯内存实现强制执行与生产环境相同的不变量（可见性、slug 唯一性、每个账户一票、幂等 upsert、发布日期稳定）。工具层分辨不出自己在跟哪一个对话——这也正是整个服务器可测试的原因。

• 草稿优先的发布。 一切先以草稿落地；publish_game 校验累积的状态（宣传语、分类、可玩构建），并且是通向可见性的唯一入口。

• 成就是创作者的数据。 工具负责定义成就；本服务器中没有任何东西会解锁它们。解锁路径属于面向游戏的运行时 API，而这一分离——刻意设计、记录在案、以缺失强制实施——正是让徽章保持意义的原因。

• 横切层即模块。 认证、限流、错误整形和媒体校验（包括 SSRF 私网段检查）都是供管道组合的小型纯文件，而非中间件魔法。

目录结构

Apache-2.0 · aimade.games 的发布接口（生产实例）· 由 Elliot Himmelfarb 使用 Claude Code 构建