Skip to main content
Glama
CityEngine Cloud MCP Server

CityEngine Cloud MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CITYENGINE_API_KEYYesPlugin API key (cvk_…) required to use the CityEngine Cloud MCP server.
CITYENGINE_DEMOS_BASENoDemo listing site base URL.https://www.cityengine.cn
CITYENGINE_MAX_POLL_SNoRender job poll cap in seconds.300
CITYENGINE_OUTPUT_DIRNoDirectory where generated glb files land../cityengine_mcp_output
CITYENGINE_GATEWAY_BASENoGateway base URL.https://api.cityengine.cn

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

CityEngine 云端能力:CGA 规则解析生成三维模型(glTF/glb)、自然语言一句话生成 CGA 规则(NL2CGA)、一句话直接生成三维模型、官网 demo 案例查询。所有工具均为只读计算型接口。

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
parse_cgaA

用 CityEngine 引擎解析 CGA 规则源码,生成三维模型(glTF/glb)。

Args: cga_source: CGA 规则源码全文(手写或 generate_cga 的产物)。 attributes: CGA attr 覆盖,如 {"height": 30};键必须在规则的 attr 声明内。 initial_shape: 初始地块多边形 {"type":"Polygon","pts":[[x,z],...]},米制; 缺省用 30m x 20m 调试地块。 seed: 随机种子,固定后可复现结果。 download_glb: 是否把 glb 下载到本地(默认 True)。 output_dir: glb 落盘目录(默认环境变量 CITYENGINE_OUTPUT_DIR 或当前目录下 cityengine_mcp_output/)。 timeout_s: 轮询 job 的最长秒数(上限 300)。

Returns: job_id、模型统计(nodes/vertices/triangles/textures_embedded)、glb 本地路径、 签名下载地址(24h 有效)、sha256、计费用量、告警列表。

generate_cgaA

自然语言一句话 → NL2CGA → CGA 规则源码(不渲染,同步返回)。

两种模式二选一:

  1. text:自然语言描述,如「三层小楼,坡屋顶,底层商铺」。

  2. base_cga + instruction:在既有 CGA 上按指令修改(如「把立面材质改成红砖」)。

LLM 兜底模式最长约 90s,属正常现象。

Returns: cga_source(可喂给 parse_cga / generate_model 的 cga_edit 回传)、 engine_path(self/kimi_fallback/hybrid)、warnings、usage。

generate_modelB

自然语言一句话 → 直接生成三维模型(NL2CGA + 引擎解析一键串联)。

两种模式二选一:

  1. text:自然语言描述,如「生成一栋 12 层现代玻璃幕墙办公楼」。

  2. base_cga + instruction:回传既有 CGA + 修改指令,二次生成再出模型。

Args:(其余参数同 parse_cga)

Returns: cga_source(供后续 cga_edit 回传)、模型统计、glb 本地路径、 签名下载地址、sha256、usage、warnings。

list_demosA

列出 CityEngine 官网首页的 demo 案例(id、名称、引擎、来源日期、属性个数)。

返回条目可传给 get_demo 查看属性面板细节。

get_demoA

查看某个官网 demo 案例的详情:属性面板定义、材质数、节点数、引擎耗时。

注意:demo 的 CGA 源码属付费内容(官网商城),本工具返回公开快照信息 (属性 schema / 规模 / 引擎指标),适合做参数设计参考。

Args: demo_id: list_demos 返回的 id,如 building-glass-20260928。

get_quotaA

查询当前 API key 的套餐、额度用量(generate/NL2CGA)与限流参数。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 6 tools

Disambiguation4/5

parse_cga, generate_cga, and generate_model have related purposes, but descriptions clearly delineate them (parse renders CGA, generate_cga returns only source, generate_model chains both). The generate_model/generate_cga overlap could still cause some misselection when an agent just wants a model.

Naming Consistency5/5

All names follow a consistent verb_noun snake_case pattern (parse_cga, generate_cga, generate_model, list_demos, get_demo, get_quota). No mixed conventions or vague verbs.

Tool Count5/5

Six tools is well-scoped for a CGA generation/rendering service, with each tool earning a distinct role. Nothing feels padded or missing at the count level.

Completeness4/5

The core lifecycle (NL→CGA, CGA→model, combined flow) plus demos and quota is covered. Minor gaps exist around job lifecycle management (no cancel/list jobs) and standalone model retrieval, but agents can work around these.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues