PowerCMS X ブログ

2026-11-16

AIが生成したモデル定義JSONをPowerCMS Xの仕様に沿って検証する — MCPサーバーの活用例

先日開催いたしましたオンラインセミナー「PowerCMS X 最新動向 PowerCMS X AI 新機能の展望 & アクセス解析ツールMatomoとは?」では、私のセッションでMCPサーバーを利用し、朝日地球会議のチラシPDFからイベント情報をPowerCMS Xのイベントモデルに登録するデモをご覧いただきました。

セミナーではご紹介できませんでしたが、開発中のMCPサーバーではコンテンツの登録だけでなく、「モデル定義JSONの検証機能」や「テンプレートタグの検索機能」といった開発者向けの機能も検討しています。

今回は、そのうち「モデル定義JSONの検証機能」をご紹介します。

モデル定義JSONの検証機能とは

Claude CodeやCodexなどのAIを利用して、PowerCMS Xのプラグインを開発する機会も増えてきました。例えば、entry.jsonなど既存のモデル定義JSONを参考資料として渡せば、新しいモデル定義JSONを生成してもらうことができます。

ただし、生成されたJSONが構文的に正しくても、PowerCMS X固有の仕様に沿っているとは限りません。

PowerCMS Xには、オプションを有効にすると自動的に追加されるカラムがあります。そのため、column_defsにカラムが定義されているのに対応するオプションが有効になっていない、といったズレが生じることがあります。また、データベース上では定義できても、PowerCMS Xの管理画面から編集すると設定が変わってしまうケースもあります。

このような点を、PowerCMS Xのモデル機能の仕様に基づいてチェックするのが、MCPサーバーの「モデル定義JSONの検証機能」です。

AIに仕様書や既存のJSONを渡して判断させる方法もありますが、この機能では専用の検証処理をMCPツールとして呼び出せます。AIが生成したJSONを検証し返された指摘をもとに修正する、といった開発フローにも活用できます。

検証機能の動作例

AIとMCPサーバーのやり取りは見えないので、今回はMCPサーバーのツールを試すための「MCP Inspector」を使ってモデル定義JSONを検証してみます。

MCP Inspectorでモデル定義JSONの検証ツールを実行した画面。ツール名と結果が見える

1. カラムとオプションの不一致を確認する

例えば、作成日時・更新日時、作成者・更新者のカラムを定義しているのに、対応するauditingオプションが有効になっていないケースです。

次のモデル定義JSONには、created_on、modified_on、created_by、modified_byがありますが、auditingの指定はありません(説明に関係する部分のみ抜粋しています)。

{
  "label": "Short Movie",
  "primary": "title",
  "column_defs": {
    "title": {
      "type": "string",
      "size": 255,
      "not_null": 1
    },
    "created_on": { "type": "datetime" },
    "modified_on": { "type": "datetime" },
    "created_by": { "type": "int", "size": 11 },
    "modified_by": { "type": "int", "size": 11 }
  }
}

このモデル定義JSONを検証すると、OPT-06というルールによって次の情報が返されました(出力の一部を抜粋)。

{
  "valid": true,
  "summary": {
    "error": 0,
    "warn": 0,
    "info": 1
  },
  "findings": [
    {
      "rule": "OPT-06",
      "severity": "info",
      "message": "カラムはありますが、それを生成するオプションが有効になっていません: created_on (auditing = 1), modified_on (auditing = 2), created_by (auditing = 1), modified_by (auditing = 2)",
      "detail": "カラム自体は動作します。オプションは管理画面の挙動を制御するものなので、その機能が必要なら有効にしてください。"
    }
  ]
}

validはtrueで、指摘の重要度もinfoです。これはカラムの定義そのものが誤りという意味ではありません。カラムは動作しますが、対応するオプションが有効ではないことを、開発者が確認できるように知らせています。

検証結果には、error(エラー)、warn(警告)、info(補足情報)という区分があります。仕様上許容される定義でも、確認しておいた方がよい点を伝えられるようにしています。

2. テキストカラムの長さを確認する

もう一つは、PowerCMS Xの「テキスト」(varchar)カラムのサイズに関する例です。titleカラムのsize(文字数)を510としてみます。

"title": {
  "type": "string",
  "size": 510,
  "not_null": 1
}

検証すると、今度はCOL-03という警告が返されます(出力の一部を抜粋)。

{
  "valid": true,
  "summary": {
    "error": 0,
    "warn": 1,
    "info": 0
  },
  "findings": [
    {
      "rule": "COL-03",
      "severity": "warn",
      "message": "50 / 255 / 768 以外のサイズを使っている string カラムです: title(510)",
      "path": "/column_defs",
      "detail": "スキーマ管理画面の型は tinystr(50) / string(255) / longstr(768) の 3 段しかないため、次に管理画面から保存した時点でサイズが丸められます。"
    }
  ]
}

size: 510はJSONの構文としては問題ありません。しかし、PowerCMS Xのスキーマ管理画面で扱うテキストカラムのサイズは、50・255・768の3段階です。このため、管理画面からスキーマを保存したときに、意図したサイズが維持されない可能性があります。

これはJSONの構文チェックだけでは発見できない、PowerCMS Xの管理画面の挙動に関わる問題です。

AIを利用した開発での活用

今回はリクエストとレスポンスを明確にするためにMCP Inspectorから検証ツールを直接呼び出しましたが、プラグイン開発時などには次のような流れでの活用を試行しています。

  1. Claude CodeやCodexに、既存のモデル定義JSONなどを参考に新しいモデルを設計させる
  2. 生成したモデル定義JSONをMCPサーバーのツールで検証する
  3. error・warn・infoの指摘内容を確認し、必要に応じてAIに修正させる
  4. 確認したモデル定義JSONをPowerCMS Xに適用する

検証機能はモデル定義のあらゆる問題を保証付きで発見するものではありませんが、AIだけでは見落としがちなPowerCMS X固有の仕様を確認する助けになります。

Claude CodeがMCPサーバーからの情報を受けてモデル定義JSONを自動修正している画面

まとめ

「モデル定義JSONの検証機能」を利用することで、AIが生成したモデル定義JSONについても、PowerCMS X固有の仕様に基づいたチェックが可能になります。検証・修正したモデル定義JSONは、tools/upgrader.php --models short_movieのようなコマンドで適用できます。また、JSONファイルとしてGitでバージョン管理できることもメリットです。

AIによる開発の効率化と、PowerCMS Xの仕様に沿ったモデル設計を両立するための機能として、今後も開発を進めていきたいと考えています。

次回は「テンプレートタグの検索機能」についてご紹介いたします。

カテゴリー:技術情報

投稿者:安倍

ブログ内検索

アーカイブ


日本語
ふりがな付き
English
简体中文
繁體中文
한국어