NL→CGA rules, CGA→3D(GLB) compile & official-engine parse for CityEngine/CGA.js/NL2CGA. 11 tools.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <CITYVISTION_API_KEY> — unified key works for all three services; per-service headers x-cgajs-key / x-nl2cga-key / x-cityengine-key also accepted.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
把 CGA 规则源码编译为三维模型(GLB),经 CGA.js 云端引擎。
CGA 规则源码全文(需含 @StartRule 与 Lot 规则)。
"" = js(默认,×1 配额);"python" = 服务器原生引擎(×3 配额, 对 CityEngine 方言兼容性更好)。
glb 落盘目录。
是否把 glb 落盘(默认 True)。
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http cityvistion-mcp https://mcp.cgajs.com/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Bearer <CITYVISTION_API_KEY> — unified key works for all three services; per-service headers x-cgajs-key / x-nl2cga-key / x-cityengine-key also accepted.把 CGA 规则源码编译为三维模型(GLB),经 CGA.js 云端引擎。
| Argument | Type | Description |
|---|---|---|
| engine | string | "" = js(默认,×1 配额);"python" = 服务器原生引擎(×3 配额, 对 CityEngine 方言兼容性更好)。 |
| cga_source* | string | CGA 规则源码全文(需含 @StartRule 与 Lot 规则)。 |
| output_dir | any | glb 落盘目录。 |
| download_glb | boolean | 是否把 glb 落盘(默认 True)。 |
{
"type": "object",
"required": [
"cga_source"
],
"properties": {
"engine": {
"type": "string",
"default": "",
"description": "\"\" = js(默认,×1 配额);\"python\" = 服务器原生引擎(×3 配额,\n 对 CityEngine 方言兼容性更好)。"
},
"cga_source": {
"type": "string",
"description": "CGA 规则源码全文(需含 @StartRule 与 Lot 规则)。"
},
"output_dir": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "glb 落盘目录。"
},
"download_glb": {
"type": "boolean",
"default": true,
"description": "是否把 glb 落盘(默认 True)。"
}
},
"additionalProperties": false
}查询 CGA.js 当前 API key 的套餐档位与本月额度用量。
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}自然语言 → CGA 规则源码(CityEngine 网关 NL2CGA 通道,不渲染)。 两种模式二选一: 1. text:自然语言描述,如「三层小楼,坡屋顶,底层商铺」。 2. base_cga + instruction:在既有 CGA 上按指令修改。
| Argument | Type | Description |
|---|---|---|
| text | any | |
| base_cga | any | |
| instruction | any |
{
"type": "object",
"properties": {
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"base_cga": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"instruction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}自然语言一句话 → 直接生成三维模型(NL2CGA + CityEngine 引擎一键串联)。 两种模式二选一: 1. text:自然语言描述,如「生成一栋 12 层现代玻璃幕墙办公楼」。 2. base_cga + instruction:回传既有 CGA + 修改指令,二次生成再出模型。
| Argument | Type | Description |
|---|---|---|
| seed | any | |
| text | any | |
| base_cga | any | |
| timeout_s | number | |
| attributes | any | |
| output_dir | any | |
| instruction | any | |
| download_glb | boolean | |
| initial_shape | any |
{
"type": "object",
"properties": {
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"base_cga": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"timeout_s": {
"type": "number",
"default": 300
},
"attributes": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"default": null
},
"output_dir": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"instruction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"download_glb": {
"type": "boolean",
"default": true
},
"initial_shape": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}查看官方案例的参数规格(属性 schema/规模/引擎指标),免 API key。
| Argument | Type | Description |
|---|---|---|
| demo_id* | string | cityengine_list_demos 返回的 id,如 building-glass-20260928。 |
{
"type": "object",
"required": [
"demo_id"
],
"properties": {
"demo_id": {
"type": "string",
"description": "cityengine_list_demos 返回的 id,如 building-glass-20260928。"
}
},
"additionalProperties": false
}查询 CityEngine 当前 API key 的套餐、额度用量(generate/NL2CGA)与限流参数。
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}解析 CGA 源码的可调属性(名称/类型/默认值/取值范围/枚举),免 API key。 与 cityengine.cn 网页端 /api/v1/cv/inspect 同一接口,适合在渲染前自检参数面板。
| Argument | Type | Description |
|---|---|---|
| cga_source* | string | CGA 规则源码全文。 |
{
"type": "object",
"required": [
"cga_source"
],
"properties": {
"cga_source": {
"type": "string",
"description": "CGA 规则源码全文。"
}
},
"additionalProperties": false
}列出 CityEngine 官方案例库(id、名称、引擎、参数个数、缩略图),免 API key。
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}用 CityEngine 官方引擎解析 CGA 规则源码,生成三维模型(GLB)。
| Argument | Type | Description |
|---|---|---|
| seed | any | 随机种子(固定后可复现)。 |
| timeout_s | number | |
| attributes | any | CGA attr 覆盖,如 {"height": 30}(键须在规则 attr 声明内)。 |
| cga_source* | string | CGA 规则源码全文。 |
| output_dir | any | |
| download_glb | boolean | |
| initial_shape | any | 初始地块多边形 {"type":"Polygon","pts":[[x,z],...]},米制。 |
{
"type": "object",
"required": [
"cga_source"
],
"properties": {
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "随机种子(固定后可复现)。"
},
"timeout_s": {
"type": "number",
"default": 300
},
"attributes": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"default": null,
"description": "CGA attr 覆盖,如 {\"height\": 30}(键须在规则 attr 声明内)。"
},
"cga_source": {
"type": "string",
"description": "CGA 规则源码全文。"
},
"output_dir": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"download_glb": {
"type": "boolean",
"default": true
},
"initial_shape": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"default": null,
"description": "初始地块多边形 {\"type\":\"Polygon\",\"pts\":[[x,z],...]},米制。"
}
},
"additionalProperties": false
}用一句自然语言生成 CGA 规则源码(NL2CGA,同步等待直到完成,不渲染模型)。
| Argument | Type | Description |
|---|---|---|
| prompt* | string | 自然语言建模描述,如「三层临街商铺,骑楼退界」。 |
| timeout_s | number | 最长等待秒数(上限 300)。 |
{
"type": "object",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"description": "自然语言建模描述,如「三层临街商铺,骑楼退界」。"
},
"timeout_s": {
"type": "number",
"default": 300,
"description": "最长等待秒数(上限 300)。"
}
},
"additionalProperties": false
}查询 NL2CGA 生成任务状态(queued/running/succeeded/failed)与结果。
| Argument | Type | Description |
|---|---|---|
| job_id* | string | nl2cga_generate_cga 返回的 job_id。 |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "nl2cga_generate_cga 返回的 job_id。"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.