JCGE Agent Interface

JCGEAgentInterface

什么是 CGE？

可计算一般均衡（CGE）模型是一种定量经济模型，将经济表示为由商品和服务、生产要素、机构以及世界其他地区组成的相互关联的市场。它使用数据（通常是社会核算矩阵）进行校准，并通过数值方法求解非线性方程组，直到均衡条件（零利润、市场出清和收入平衡）在容差范围内成立。

什么是 JCGE？

JCGE 是一个基于 Julia 的模块化 CGE 建模与执行框架。它定义了共享的 RunSpec 结构和可复用模块，使模型能够在不同软件包之间以一致的方式进行组装、验证、求解和比较。

这个软件包是什么？

面向需要发现、加载、求解、验证和检查 JCGE 模型的 Agent 的 MCP 兼容接口层。它通过相同的功能提供精简的操作 API 和标准 MCP stdio 服务。

面向 Agent 的功能有意聚焦于：

• 发现已安装的 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() 从 stdin 读取 JSON 请求，并将 JSON 响应写入 stdout。

Docker 和 MCP Registry

面向 OCI 的 MCP Registry 元数据在 server.json 中声明。

未来匹配 v*.*.* 的版本标签会触发 .github/workflows/publish-mcp.yml，该工作流将：

• 验证标签版本是否与 Project.toml 一致，
• 构建 MCP Docker 镜像，
• 将镜像推送至 GitHub Container Registry，镜像地址为 ghcr.io/equicirco/jcge-agentinterface-mcp:<release-version>，
• 更新该版本的 server.json，
• 通过 GitHub OIDC 将元数据发布到官方 MCP Registry。

Docker 镜像包含 MCP Registry 要求的 MCP 所有权标签：

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

仅编辑此仓库不会执行任何版本发布、打标签、镜像发布或 Registry 发布。

如何引用

如果您使用 JCGE 框架，请引用：

Boero, R. JCGE - Julia 可计算一般均衡框架 [软件]，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 兼容 Agent 接口。 [软件]，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（更适合精确复现）。