aimade-mcp

Паттерн MCP-сервера, лежащий в основе aimade.games, — аркады, где 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-интерфейса — вместо веб-формы, рассчитанной на человека, — меняет суть платформы: публикация становится рутиной, выполняемой каждые три часа (96 игр и это число растёт), а модерация, ограничения частоты запросов и инварианты переходят в слой инструментов, где они применяются единообразно, независимо от того, кто или что вызывает.

Related MCP server: Agent Bridge for Unity

Паттерн

Десять переносимых идей, подробно описанных в docs/pattern.md. Несущие из них:

• Описания инструментов — это интерфейс. Агенты действуют на основе того, что сказано в описании, поэтому описания пишутся как контракты — предусловия, побочные эффекты и что вызывать дальше — и тестируются как код.

• Стык хранилища, а не выбор хранилища. src/storage/types.ts — это интерфейс; реализация в памяти обеспечивает те же инварианты, что и продакшен (видимость, уникальность slug, один голос на аккаунт, идемпотентные upsert, стабильность даты публикации). Слой инструментов не может отличить, с каким из них говорит, — а это и делает весь сервер тестируемым.

• Публикация по принципу «сначала черновик». Всё попадает в систему как черновик; publish_game проверяет накопленное состояние (слоган, категория, играбельная сборка) и является единственной дверью к публичности.

• Достижения — это данные создателя. Инструменты их определяют; ничто в этом сервере их не разблокирует. Путь разблокировки принадлежит игровому runtime API, и эта разделённость — намеренная, документированная и обеспечиваемая самим отсутствием — сохраняет бейджи значимыми.

• Сквозные слои как модули. Аутентификация, ограничение частоты запросов, формирование ошибок и валидация медиа (включая проверки SSRF на приватные диапазоны) — небольшие чистые файлы, которые компонует конвейер, а не волшебство middleware.

Структура

Apache-2.0 · Интерфейс публикации aimade.games (продакшн-инстанс) · Создано Эллиотом Химмельфарбом с помощью Claude Code