MetaEngine

MetaEngine MCP 服务

通过 MCP 客户端，根据类型图、精简的 JSON 配方或 API 架构生成相关源文件。

MetaEngine 将结构化类、接口、枚举、集合和泛型，与 customCode 中提供的目标语言代码相结合。显式引用将这些代码连接到同一个类型图，因此生成器可以解析批次中的名称和导入。你可以用它生成模型、服务、适配器或其他你所描述的结构；此格式不会规定应用架构。

安装

需要 Node.js 18 或更高版本。将此服务添加到 MCP 客户端的配置中：

{
  "mcpServers": {
    "metaengine": {
      "command": "npx",
      "args": ["-y", "@metaengine/[email protected]"]
    }
  }
}

对于 Claude Code：

claude mcp add metaengine -- npx -y @metaengine/[email protected]

托管服务无需 API 密钥或账户。支持 stdio 的 MCP 客户端包括 Claude Code、Claude Desktop、Cursor、Cline 等。

从配方开始

使用以下参数调用 generate_from_recipe：

{
  "recipe": {
    "recipeVersion": 1,
    "language": "typescript",
    "typeScriptOptions": { "relativeImportExtension": "js" },
    "classes": [
      { "name": "Customer", "id": "customer", "properties": { "id": "string", "name": "string" } },
      { "name": "Order", "properties": { "customer": { "ref": "customer" }, "total": "number", "note?": "string" } }
    ]
  },
  "outputPath": "src/models"
}

本地 MCP 服务会将配方扩展为现有的生成负载，将该负载发送到 MetaEngine API，并写入返回的文件。如果结构重复，可以添加命名模板和参数行。现有的 customCode、templateRefs、导入、装饰器、继承和泛型定义仍可使用。

可以通过 {"recipeFilePath":"specs/models.recipe.json"} 调用受版本控制的配方。在工具调用中读取文件可避免重复发送其内容。不过，文件仍需编写或维护。

配方语法与示例 · 生成指南 · 语言示例

工具

工具	用途
generate_from_recipe	将精简的 JSON 字段、命名模板和本地 JSON 输入行扩展为现有类型图，然后生成文件。
generate_code	根据完整的原生 JSON 类型图生成代码，包括带显式引用的任意目标语言代码。
load_spec_from_file	从本地 JSON 文件读取原生 generate_code 负载。
generate_openapi	根据内联提供或通过 URL 提供的 OpenAPI 文档生成类型化客户端。
generate_graphql	根据 GraphQL SDL 生成类型化客户端，并可选择使用命名片段。
generate_protobuf	根据 Protocol Buffers 定义生成类型化客户端。
generate_sql	根据 SQL DDL 生成模型类型。
metaengine_initialize	为助手加载生成规则和语言说明。

类型和模型生成支持 TypeScript、Python、Go、C#、Java、Kotlin、Groovy、Scala、Swift、PHP 和 Rust。客户端生成面向 Angular、React、TypeScript Fetch、Go net/http、Java Spring、Python httpx、C# HttpClient、Kotlin Ktor、Rust Reqwest 和 Swift URLSession。

generate_code、load_spec_from_file 和 generate_from_recipe 共享生成和文件写入行为：

• outputPath 用于选择本地输出目录；默认使用 MCP 服务的工作目录。
• skipExisting 默认为 true。将其设为 false 可覆盖生成的文件。
• dryRun: true 会返回生成的文件内容，但不会写入文件。生成过程仍会调用托管 API。
• 相关类型引用会在一个批次内解析。请在该次调用中包含完整类型图。
• 托管服务的限制是每个生成请求最多计数 250 个类型。具体计数方式见配方指南。

对于 Node16/NodeNext TypeScript ESM，请使用 typeScriptOptions: {"relativeImportExtension":"js"}。其他 TypeScript 输出默认保留不带扩展名的相对导入。

配方适用场景

字段映射可省去重复的属性元数据。模板只需描述一次重复结构，并绑定明确的参数值。本地 JSON 输入可以从你已维护的文件中提供这些值。适配器不会执行配方中的 JavaScript。

节省效果取决于重复内容的多少、所选模型和分词器，以及周边的 Agent 工作流。自定义业务逻辑仍需编写。一份已记录的开发测试样例对比了包含 59 个接口的配方及其展开后的负载；它衡量的是 JSON 字节数，而非模型词元数，也不保证使用限额。

精简格式为常见声明保留了一条易读的路径，同时支持使用现有原生字段编写高级代码。原生类型表达式和 customCode 仍针对各自的目标语言。请在项目中审查并编译生成的代码，包括其依赖项和编译器设置。

隐私与执行

本地 MCP 服务通过 stdio 运行，负责展开配方、读取声明的本地文件，以及写入生成的文件。托管的 MetaEngine API 会对展开后的生成负载进行临时处理，并返回源文件。

服务不会自动扫描或上传现有项目源文件。明确包含在生成请求中的源代码或 customCode 内容属于该请求的一部分，并会发送至托管的 MetaEngine API。只有当配方使用了从配方输入中读取的值时，这些值才会包含在展开后的负载中。

提交的生成内容和生成的文件内容不会被持久化或记录；匿名运行元数据会予以保留。有关处理和保留详情，请参阅隐私政策和条款。

已记录的 Agent 工作流

一次 MCP 调用可生成多个文件，从而减少所需的工具操作次数。模型响应是另一项独立指标：在已记录的 TypeScript 运行中，Opus 通常每次响应发出一次 Write，而 Sonnet 通常会批量处理 Write。修正后的基准测试结果区分了这两类计数，并保留了输出词元总数和通过率。

如需跨语言、模型和规格形态进行可复现的测量，请参阅 benchmark/——这是一个自包含的测试框架，包含提示词、评测工具和 15 个规范结果文件夹。其中的数据展示的是一位作者在每个单元格 N=5 的情况下进行测试所得的结果；请在自己的环境中复现，以了解哪些结果适用于你。

链接

• npm 包
• 网站
• 体验场
• 文档与问题跟踪

许可证

MIT

关于此仓库

此仓库包含 MetaEngine MCP Server 的公开文档、示例、基准测试和问题跟踪。已编译的 npm 包可在 @metaengine/mcp-server 获取。服务实现维护在私有仓库中。