Repository avatar
Other Tools
v0.1.2
active

cityvistion-mcp

com.cgajs/cityvistion-mcp

NL→CGA rules, CGA→3D(GLB) compile & official-engine parse for CityEngine/CGA.js/NL2CGA. 11 tools.

Documentation

cityvistion-mcp

mcp-name: com.cgajs/cityvistion-mcp

一套 MCP server 打通三个云端服务,让任何支持 MCP 的大模型客户端(Claude Code、codex、Gemini CLI、Kimi Code、Qwen Code、GLM Coding、Cherry Studio、Cline、Cursor、MiniMax Agent…)直接完成「一句话 → CGA 规则 → 三维模型」全链路。

  • NL2CGA:自然语言生成 CGA 规则源码(nl2cga_generate_cga)
  • CGA.js:CGA 规则在线编译为三维模型 GLB(cgajs_compile_cga)
  • CityEngine:官方引擎解析、一句话直接出模、官方案例库查询(cityengine_*,其中 inspect_cga / list_demos / get_demo 免 key)

安装

pip install cityvistion-mcp
# 或 uvx cityvistion-mcp(免安装直接跑)

API Key

服务环境变量签发地址
CGA.jsCGAJS_API_KEYhttps://www.cgajs.com 控制台
NL2CGANL2CGA_API_KEYhttps://www.nl2cga.com 「我的 Key」
CityEngineCITYENGINE_API_KEYhttps://www.cityengine.cn 用户中心「插件 Key」
统一 keyCITYVISTION_API_KEY单服务未配专属 key 时回退尝试

客户端配置

Claude Code(.mcp.json 或 claude mcp add):

{
  "mcpServers": {
    "cityvistion": {
      "command": "uvx",
      "args": ["cityvistion-mcp"],
      "env": {
        "CGAJS_API_KEY": "<你的key>",
        "NL2CGA_API_KEY": "<你的key>",
        "CITYENGINE_API_KEY": "<你的key>"
      }
    }
  }
}

codex CLI(~/.codex/config.toml):

[mcp_servers.cityvistion]
command = "uvx"
args = ["cityvistion-mcp"]
env = { CGAJS_API_KEY = "<你的key>", NL2CGA_API_KEY = "<你的key>", CITYENGINE_API_KEY = "<你的key>" }

Gemini CLI(~/.gemini/settings.json)、Kimi Code(~/.kimi/config.toml)、Qwen Code、GLM Coding:同上结构,详见 https://www.cgajs.com/ai-access.html

托管模式(免本地安装):https://mcp.cgajs.com/mcp(streamable-http),在客户端填 URL,key 用请求头 x-cgajs-key / x-nl2cga-key / x-cityengine-key 或 Authorization: Bearer <统一key> 传递。

典型用法(对模型说)

用 nl2cga 生成「两层坡屋顶小屋」的 CGA,再用 cgajs 编译成模型,告诉我顶点数和文件路径。

License

MIT