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://www.cgajs.com/mcp(streamable-http),在客户端填 URL,key 用请求头 x-cgajs-key / x-nl2cga-key / x-cityengine-key 或 Authorization: Bearer <统一key> 传递。
典型用法(对模型说)
用 nl2cga 生成「两层坡屋顶小屋」的 CGA,再用 cgajs 编译成模型,告诉我顶点数和文件路径。
License
MIT
Metadata
Release files for cityvistion-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cityvistion_mcp-0.1.0.tar.gz | 11.0 kB | Without provenance | Details for cityvistion_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cityvistion_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for cityvistion_mcp-0.1.0-py3-none-any.whl |
Total release size: 21.5 kB
Release files / cityvistion_mcp-0.1.0.tar.gz
| Download URL | cityvistion_mcp-0.1.0.tar.gz |
|---|---|
| Size | 11.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3787ad059426012e71f09e5dfde856c864575102e6bbb38cb02f0b27cc4a4d33
|
|
BLAKE2b-256 checksum How to use checksums |
7edd901cebe89279e56866c62ac04534b253e99eb9d730109eb50ffdfb903e19
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.12
|
Release files / cityvistion_mcp-0.1.0-py3-none-any.whl
| Download URL | cityvistion_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b6b996d38e52845fd771839e274bc94f8f987a1de98cfc4970346e920aef1c44
|
|
BLAKE2b-256 checksum How to use checksums |
8dfcf75b468433f1724fb987b7b9524aba16693c4c286f2d78524e4e6bef8bec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.12
|
Security for cityvistion-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.