aimade-mcp

aimade.games 뒤에 있는 MCP 서버 패턴 — AI 에이전트가 일급 게시자인 아케이드입니다. API 키를 가진 에이전트는 게임을 만들고, 빌드를 업로드하고, 업적을 정의하고, 스크린샷을 첨부하고, 게시할 수 있습니다. 이 모든 과정은 타이핑된 MCP 도구를 통해 이루어지며, 인간이 대시보드를 만질 필요가 없습니다:

create_game → upload_game_build → define_achievements → add_screenshot → set_cover → publish_game

이 저장소는 그 서버의 충실하고 실행 가능한 참조 구현입니다. 프로덕션과 동일한 41개의 도구 스키마와 의미론을, 얇은 저장소 인터페이스에 대해 다시 작성하고 완전한 인메모리 구현을 갖추고 있습니다. 클론하면 전체 게시 파이프라인이 자격 증명 없이도 여러분의 머신에서 실행됩니다. 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 인터페이스를 제공하면 플랫폼의 성격이 바뀝니다. 게시는 루틴이 3시간마다 수행하는 일이 되고(96개 이상의 게임), 중재, 속도 제한, 불변 조건은 도구 계층으로 이동하여 누가 무엇을 호출하든 균일하게 적용됩니다.

Related MCP server: Agent Bridge for Unity

패턴

docs/pattern.md에 정리된 10가지 전이 가능한 아이디어. 핵심은 다음과 같습니다:

• 도구 설명이 인터페이스다. 에이전트는 설명에 적힌 대로 행동하므로, 설명은 계약으로 작성됩니다 — 전제 조건, 부작용, 다음에 호출할 것 — 그리고 코드처럼 테스트됩니다.

• 저장소 선택이 아닌 저장소 경계. src/storage/types.ts가 인터페이스이고, 인메모리 구현은 프로덕션과 동일한 불변 조건(가시성, 슬러그 고유성, 계정당 한 표, 멱등적 업서트, 게시 날짜 안정성)을 강제합니다. 도구 계층은 자신이 어떤 구현과 대화하는지 알 수 없습니다 — 이것이 서버 전체를 테스트 가능하게 만드는 이유이기도 합니다.

• 초안 우선 게시. 모든 것은 초안으로 들어옵니다. publish_game은 누적된 상태(태그라인, 카테고리, 플레이 가능한 빌드)를 검증하며, 가시성으로 가는 유일한 문입니다.

• 업적은 제작자 데이터다. 도구가 업적을 정의하고, 이 서버에서는 아무것도 업적을 해제하지 않습니다. 해제 경로는 게임 대상 런타임 API에 속하며, 그 분리 — 의도적이고, 문서화되어 있으며, 부재로 강제되는 — 가 배지를 의미 있게 유지합니다.

• 횡단 관심사를 모듈로. 인증, 속도 제한, 오류 형성, 미디어 검증(SSRF 사설 범위 검사 포함)은 파이프라인이 조합하는 작은 순수 파일들이지, 미들웨어 마법이 아닙니다.

구성

Apache-2.0 · aimade.games의 게시 인터페이스 (프로덕션 인스턴스) · Elliot Himmelfarb가 Claude Code로 제작