# MetaEngine

> MetaEngine is an open-source MCP server for developer tools. Generate typed code in 11 languages from JSON recipes, type graphs and API schemas. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Linux, macOS, Windows
- **Website:** https://www.metaengine.eu/mcp
- **Repository:** https://github.com/meta-engine/mcp-server
- **MCP Registry name:** eu.metaengine/mcp-server
- **Categories:** developer tools
- **Listing updated:** 2026-11-17

## About

MetaEngine takes a description of types rather than a prompt for code. You supply a compact JSON recipe, a full type graph, or an OpenAPI, GraphQL, Protocol Buffers or SQL DDL source, and the server writes related source files to a local folder. Explicit references between types let the generator resolve names and imports across a whole batch, and hand-written code can be attached through customCode.

Recipes keep repeated structure short: a trailing question mark marks an optional field, a ref points at another type, and named templates with parameter rows expand locally before anything is sent. Unknown fields, unresolved references and duplicate names fail on your machine before the hosted request. Generation itself runs on the MetaEngine API, which the site says processes payloads ephemerally without storing or logging them, and needs no key or account.

Each request is limited to 250 counted types and 5 MiB of JSON. Existing files are skipped by default, and a dry run returns the output without writing it. Output covers TypeScript, Python, Go, C#, Java, Kotlin, Groovy, Scala, Swift, PHP and Rust, with typed clients for frameworks such as Angular, React and Spring.

## Features

- **Recipe generation:** Expand compact JSON recipes with templates into full type graphs, then generate files.
- **Native type graphs:** Generate from a complete graph including custom target-language code.
- **API client generation:** Typed clients from OpenAPI, GraphQL SDL and Protocol Buffers.
- **SQL model types:** Create model types from SQL DDL.
- **Safe file writing:** Skips existing files by default and supports dry runs.
- **Local validation:** Resolves references and limits before the hosted call.

## Good for

- Regenerate an API client after a schema change
- Produce models for several languages from one definition
- Turn SQL DDL into typed models
- Keep version-controlled recipe files that rebuild models on demand

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server -- npx -y @metaengine/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@metaengine/mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@metaengine/mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@metaengine/mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@metaengine/mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@metaengine/mcp-server"
      ]
    }
  }
}
```

## Tools

- `generate_from_recipe`: Expand compact JSON recipes into a type graph and generate files.
- `generate_code`: Generate from a complete native JSON type graph.
- `load_spec_from_file`: Read a native generate_code payload from a local JSON file.
- `generate_openapi`: Generate a typed client from an OpenAPI document.
- `generate_graphql`: Generate a typed client from GraphQL SDL.
- `generate_protobuf`: Generate a typed client from Protocol Buffers definitions.
- `generate_sql`: Generate model types from SQL DDL.
- `metaengine_initialize`: Load generation rules and language notes for the assistant.

## FAQ

### Do I need an API key?

No, the README says the hosted service requires no key or account.

### What is the size limit?

250 counted types per request and a 5 MiB JSON limit for the recipe plus input files.

### Is my code uploaded?

Only the generation payload is sent; existing project source is not uploaded unless included in it.

### Which Node version?

Node.js 18 or later.

### Is MetaEngine free?

Yes. MetaEngine is open source, so you can use and self-host it for free.

### How do I add MetaEngine to Claude Code?

Run this command in your terminal: claude mcp add mcp-server -- npx -y @metaengine/mcp-server

### What are the best alternatives to MetaEngine?

The closest alternatives to MetaEngine are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/metaengine
