JCGE Agent Interface

JCGEAgentInterface

CGE とは？

計算可能一般均衡（CGE）モデルは、財・サービス、生産要素、制度、海外部門からなる相互接続された市場として経済を表現する定量的な経済モデルです。データ（通常は社会会計行列）を用いてキャリブレーションし、ゼロ利潤、市場清算、所得収支の均衡条件が許容誤差内で成立するまで、非線形方程式系を数値的に解きます。

JCGE とは？

JCGE は、Julia によるブロックベースの CCG モデリングおよび実行フレームワークです。共通の RunSpec 構造と再利用可能なブロックを定義し、パッケージ間で一貫した方法によりモデルを組み立て、検証、求解、比較できます。

このパッケージについて

JCGE モデルの検出、読み込み、求解、検証、検査を必要とするエージェント向けの MCP 対応インターフェース層です。同じ機能を通じて、小規模なアクション API と標準的な MCP stdio サーバーを提供します。

エージェント向けの機能は、意図的に次の用途に絞っています。

• インストール済みの JCGE パッケージと利用可能な機能の検出
• 再利用可能な JCGEBlocks コンポーネントの一覧表示と説明
• JCGE ブロックを使用した CGE モデル開発のユーザー向けガイド
• 等式系、不等式、MCP／相補性、最適化形式の表現など、定式化の選択肢に関するガイド
• リリース済みの JCGEImportData アダプターを用いたソースデータ準備のガイド（モデル側での SAM 構築方法の選択肢は維持）
• 現在利用可能な JCGECalibrate ローダー、SAM ヘルパー、ラベル付きコンテナー、パラメータのワークフローを用いたキャリブレーションのガイド
• 生成された方程式に基づくソルバー選択とレポートのガイド
• リリース済みの JCGEExamples 参照モデルモジュールの一覧表示
• 登録済みの RunSpec モデルの求解
• 求解済みコンテキストの検証
• JCGEOutput を通じた、実装済みの方程式、ブロック、シンボルのレンダリング
• 有効な Julia 環境でのリリース済み JCGE パッケージの更新内容の報告または適用

パッケージのサービスは、ドキュメント内で検出、モデリングガイド、モデル操作、レポート、環境保守、MCP ランタイムサービスに分類されています。サービスの契約と現在の制限については、docs/src/services.md をご覧ください。

MCP サーバー

標準の MCP トランスポートは次のとおりです。

using JCGEAgentInterface
serve(transport=:mcp_stdio)

最小構成のローカル MCP クライアント設定：

{
  "mcpServers": {
    "jcge": {
      "command": "julia",
      "args": [
        "--project=/path/to/JCGEAgentInterface.jl",
        "-e",
        "using JCGEAgentInterface; serve(transport=:mcp_stdio)"
      ]
    }
  }
}

MCP ツールでは jcge_ プレフィックスを使用します。

• jcge_capabilities
• jcge_list_blocks
• jcge_describe_block
• jcge_modeling_guide
• jcge_formulation_guide
• jcge_solver_guide
• jcge_import_data_guide
• jcge_calibration_guide
• jcge_reporting_guide
• jcge_list_examples
• jcge_package_status
• jcge_update_packages
• jcge_list_models
• jcge_load_model
• jcge_solve
• jcge_validate_model
• jcge_render_model
• jcge_export_results

従来のカスタム JSON アクションプロトコルも引き続き利用できます。

serve() は標準入力から JSON リクエストを読み込み、標準出力に JSON レスポンスを書き込みます。

Docker と MCP Registry

OCI 対応の MCP レジストリメタデータは server.json で宣言されています。

今後、v*.*.* に一致するバージョンタグを作成すると .github/workflows/publish-mcp.yml が実行され、次の処理を行います。

• タグのバージョンが Project.toml と一致することを確認する
• MCP Docker イメージをビルドする
• ghcr.io/equicirco/jcge-agentinterface-mcp:<release-version> として GitHub Container Registry にプッシュする
• そのリリースに合わせて server.json を更新する
• GitHub OIDC を通じて公式 MCP Registry にメタデータを公開する

Docker イメージには、MCP Registry が必要とする MCP 所有者ラベルが含まれます。

LABEL io.modelcontextprotocol.server.name="io.github.equicirco/JCGEAgentInterface.jl"

このリポジトリの編集によって、リリース、タグ作成、イメージ公開、レジストリへの公開が行われることはありません。

引用方法

JCGE フレームワークを使用する場合は、以下を引用してください。

Boero, R. JCGE - Julia Computable General Equilibrium Framework [ソフトウェア]、2026年。 DOI: 10.5281/zenodo.18282436 URL: https://JCGE.org

@software{boero_jcge_2026,
  title  = {JCGE - Julia Computable General Equilibrium Framework},
  author = {Boero, Riccardo},
  year   = {2026},
  doi    = {10.5281/zenodo.18282436},
  url    = {https://JCGE.org}
}

このパッケージを使用する場合は、以下を引用してください。

Boero, R. JCGEAgentInterface.jl - JCGE ツール向けの MCP 互換エージェントインターフェース。 [ソフトウェア]、2026年。 DOI: 10.5281/zenodo.18335121 URL: https://AgentInterface.JCGE.org SourceCode: https://github.com/equicirco/JCGEAgentInterface.jl

@software{boero_jcgeagentinterface_2026,
  title  = {JCGEAgentInterface.jl - MCP-compatible agent interface for JCGE tooling.},
  author = {Boero, Riccardo},
  year   = {2026},
  doi    = {10.5281/zenodo.18335121},
  url    = {https://AgentInterface.JCGE.org}
}

特定のタグ付きリリースを使用する場合は、そのリリースに対して Zenodo で割り当てられたバージョン DOI を引用してください（厳密な再現性を確保するため、こちらを推奨します）。