
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.js | CGAJS_API_KEY | https://www.cgajs.com 控制台 |
| NL2CGA | NL2CGA_API_KEY | https://www.nl2cga.com 「我的 Key」 |
| CityEngine | CITYENGINE_API_KEY | https://www.cityengine.cn 用户中心「插件 Key」 |
| 统一 key | CITYVISTION_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
PYPI
cityvistion-mcpInstall Command
pip install cityvistion-mcpRemote
streamable-http
https://mcp.cgajs.com/mcp