MetaEngine — MCP-сервер для Claude Code: генерация кода из JSON-рецептов
Превращает компактный JSON-рецепт, граф типов или API-схему в набор связанных исходников на одном из 11 языков. Полезен, когда моделей и клиентов много и писать их руками долго.
claude mcp add --env METAENGINE_API_URL=<METAENGINE_API_URL> --transport stdio metaengine -- npx -y @metaengine/mcp-serverЧто делает MetaEngine
Сервер принимает рецепт с классами, свойствами, шаблонами и ссылками между типами, разворачивает его в полный payload и отправляет в MetaEngine API, а полученные файлы записывает на диск. Ссылки на другие типы разрешаются внутри одного вызова, поэтому весь граф придётся передать за раз. Рецепт можно держать в репозитории и подсовывать через recipeFilePath вместо того, чтобы каждый раз гонять его содержимое в аргументах.
Кроме рецептов есть инструменты под OpenAPI, GraphQL SDL, Protocol Buffers и SQL DDL — из них получается типизированный клиент или модели. Отдельно generate_code работает с полным нативным графом типов, куда можно вклеить свой код на целевом языке. Запись управляется флагами: outputPath задаёт каталог, skipExisting по умолчанию true, а dryRun возвращает содержимое без записи. Лимит хостинга — 250 типов на запрос, так что большой граф придётся резать на батчи.
Ставить нужно Node.js 18 или новее. Рецепт исполняется локально без JavaScript, но развёрнутый payload уходит на хостинг MetaEngine: код, который вы явно включили в запрос, тоже отправится туда. Проект сам по себе не сканирует. Сгенерированное всё равно придётся собрать и проверить в своём проекте.
Какие задачи решает
- сгенерировать пачку связанных моделей из одного JSON-рецепта
- получить типизированный клиент по OpenAPI-документу
- собрать типы из SQL DDL без ручного переписывания
- описать повторяющуюся структуру шаблоном и подставить параметры
- разложить генерацию по каталогам и не перезаписывать готовые файлы
Примеры запросов агенту
- Вызови
generate_from_recipeдля рецепта изspecs/models.recipe.jsonи положи файлы вsrc/models - Сгенерируй типизированный клиент по этому OpenAPI-документу
- Сделай модели из этой SQL-схемы, сначала прогони с
dryRun
Как установить MetaEngine
Командой платформы
claude mcp add --env METAENGINE_API_URL=<METAENGINE_API_URL> --transport stdio metaengine -- npx -y @metaengine/mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add metaengine --env METAENGINE_API_URL=<METAENGINE_API_URL> -- npx -y @metaengine/mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"metaengine": {
"command": "npx",
"args": [
"-y",
"@metaengine/mcp-server"
],
"env": {
"METAENGINE_API_URL": "<METAENGINE_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"metaengine": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@metaengine/mcp-server"
],
"env": {
"METAENGINE_API_URL": "<METAENGINE_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e METAENGINE_API_URL=<METAENGINE_API_URL> metaengine npx -y @metaengine/mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MetaEngine
Как установить MetaEngine в Claude Code?
Выполните claude mcp add metaengine -- npx -y @metaengine/[email protected]. Нужен Node.js 18 или новее. Для своего адреса API есть вариант с --env METAENGINE_API_URL=<METAENGINE_API_URL> и транспортом stdio.
Что делает MetaEngine?
Разворачивает компактный JSON-рецепт, граф типов или API-схему в набор исходников на выбранном языке и записывает их в проект. Поддерживает TypeScript, Python, Go, C#, Java, Kotlin, Groovy, Scala, Swift, PHP и Rust.
Что нужно для работы?
Node.js 18 и старше. Аккаунт и ключ API хостингу не требуются, но развёрнутый payload уходит на сервер MetaEngine — учитывайте это, если в запрос попадает ваш код.