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 キーやアカウントは不要です。MCP クライアントには Claude Code、Claude Desktop、Cursor、Cline など、stdio に対応するものがあります。

レシピから始める

次の引数を指定して 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 が呼び出されます。
• 関連する型の参照は、1 つのバッチ内で解決されます。その呼び出しに完全なグラフを含めてください。
• ホスト型サービスでは、1 回の生成リクエストにつきカウント対象の型を 250 個まで指定できます。正確なカウント方法についてはレシピガイドを参照してください。

Node16/NodeNext の TypeScript ESM では、typeScriptOptions: {"relativeImportExtension":"js"} を使用してください。その他の TypeScript 出力では、デフォルトで拡張子のない相対インポートが使用されます。

レシピが役立つ場面

フィールドマップを使うと、繰り返されるプロパティのメタデータを省けます。テンプレートでは、繰り返し使う構造を一度だけ記述し、明示的なパラメーター値を割り当てます。ローカルの JSON 入力を使えば、すでに管理しているファイルからそれらの値を指定できます。アダプターはレシピ内の JavaScript を実行しません。

削減効果は、繰り返しの量、選択したモデルとトークナイザー、周囲のエージェントのワークフローによって異なります。独自のビジネスロジックは引き続き記述する必要があります。記録済みの開発用フィクスチャでは、59 個のインターフェースを含むレシピと展開後のペイロードを比較しています。測定するのは JSON のバイト数であり、モデルのトークン数や利用上限の保証ではありません。

コンパクトな形式では、一般的な宣言に対して読みやすいパスを維持し、高度なコードには既存のネイティブフィールドを使用します。ネイティブ型の式と customCode は、対象言語に固有のままです。依存関係やコンパイラー設定も含め、生成されたコードをプロジェクト内でレビューし、コンパイルしてください。

プライバシーと実行

ローカルの MCP サーバーは stdio 経由で動作し、レシピの展開、宣言されたローカルファイルの読み取り、生成ファイルの書き込みを行います。ホストされている MetaEngine API は、展開された生成ペイロードを一時的に処理し、ソースファイルを返します。

サーバーが既存のプロジェクトソースファイルを自動的にスキャンまたはアップロードすることはありません。生成リクエストに明示的に含めたソースや customCode の内容は、そのリクエストの一部としてホストされている MetaEngine API に送信されます。レシピ入力から読み取った値は、レシピがそれらを展開後のペイロードで使用する場合にのみ含まれます。

送信された生成コンテンツと生成ファイルの内容は保存もログ記録もされませんが、匿名化された運用メタデータは保持されます。処理と保持の詳細については、プライバシーポリシーと利用規約をご覧ください。

記録済みエージェントのワークフロー

1 回の MCP 呼び出しで多数のファイルを生成できるため、必要なツール操作を減らせます。モデルの応答は別途測定されます。記録済みの TypeScript 実行では、Opus は多くの場合、応答ごとに 1 回の Write を発行しましたが、Sonnet は通常、複数の Write をまとめていました。修正済みのベンチマーク結果では、それぞれの回数を分けて示し、出力トークンの合計数と合格率も掲載しています。

言語、モデル、仕様の形状をまたいで再現可能な測定を行うには、benchmark/をご覧ください。プロンプト、評価ツール、15 個の標準結果フォルダーを含む、自己完結型のハーネスです。掲載されている数値は、ある著者が各条件 N=5 で実行した際の例です。ご自身の環境で再現し、どの結果が当てはまるかをご確認ください。

リンク

• npm パッケージ
• ウェブサイト
• プレイグラウンド
• ドキュメントと課題

ライセンス

MIT

このリポジトリについて

このリポジトリには、MetaEngine MCP Server の公開ドキュメント、サンプル、ベンチマーク、課題追跡が含まれています。コンパイル済みの npm パッケージは @metaengine/mcp-server から入手できます。サーバーの実装は非公開リポジトリで保守されています。