CityEngine Cloud MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CITYENGINE_API_KEY | Yes | Plugin API key (cvk_…) required to use the CityEngine Cloud MCP server. | |
| CITYENGINE_DEMOS_BASE | No | Demo listing site base URL. | https://www.cityengine.cn |
| CITYENGINE_MAX_POLL_S | No | Render job poll cap in seconds. | 300 |
| CITYENGINE_OUTPUT_DIR | No | Directory where generated glb files land. | ./cityengine_mcp_output |
| CITYENGINE_GATEWAY_BASE | No | Gateway 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 规则源码(不渲染,同步返回)。 两种模式二选一:
LLM 兜底模式最长约 90s,属正常现象。 Returns: cga_source(可喂给 parse_cga / generate_model 的 cga_edit 回传)、 engine_path(self/kimi_fallback/hybrid)、warnings、usage。 |
| generate_modelB | 自然语言一句话 → 直接生成三维模型(NL2CGA + 引擎解析一键串联)。 两种模式二选一:
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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
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.
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.
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.
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.