Skip to main content

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)

Source distribution for cityvistion-mcp 0.1.0
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)

Table of built distributions (wheels) for cityvistion-mcp 0.1.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page