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://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

Metadata

Release files for cityvistion-mcp 0.1.1

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.1
File Size Uploaded Provenance Actions
cityvistion_mcp-0.1.1.tar.gz 11.0 kB Without provenance Details for cityvistion_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cityvistion-mcp 0.1.1
File Interpreter ABI Platform Actions
cityvistion_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for cityvistion_mcp-0.1.1-py3-none-any.whl

Total release size: 21.6 kB

Release files / cityvistion_mcp-0.1.1.tar.gz

Download URL cityvistion_mcp-0.1.1.tar.gz
Size 11.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4dd00bb90e6d843f7e482a1bf81361eed224b61db3e1fa2782a87a1b07176759
BLAKE2b-256 checksum
How to use checksums
9697bc6a15122fa60789d37a081c205fc3b4e3eb562e11572deda9f06800d5ca
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.1-py3-none-any.whl

Download URL cityvistion_mcp-0.1.1-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
028bf77b3d655492d86fbe8f70746957d4047f299ecc347a42083935ff4e4617
BLAKE2b-256 checksum
How to use checksums
8ef48ac135913125376182c22afaf55c603a0ee2c5d8659d61b527f9dce7f57f
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.1

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