Back to Browse

Cityengine MCP Server

by Cgajs
Developer ToolsUse Caution4.6MCP RegistryLocal
Free

Server data from the Official MCP Registry

Text-to-3D city buildings: natural language to CGA rules to rendered glTF models.

About

Text-to-3D city buildings: natural language to CGA rules to rendered glTF models.

Security Report

4.6
Use Caution4.6High Risk

This is a legitimate CityEngine Cloud client that requires an API key from an environment variable, sends requests only to the vendor's gateway and demo site, and uses no shell execution or eval. The main concerns are that the model-controllable output_dir argument allows writes to arbitrary filesystem locations, and the glb download follows any absolute URL returned by the gateway with no host check. Both are low to medium issues that do not indicate malicious behavior. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 3 high severity).

6 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

What You'll Need

Set these up before or after installing:

API key for CityEngine Cloud (get one at https://www.cityengine.cn/plugins.html)Required

Environment variable: CITYENGINE_API_KEY

Override gateway base URL (default https://api.cityengine.cn)Optional

Environment variable: CITYENGINE_GATEWAY_BASE

How to Install

Install command not verified. See the repository for install instructions.

View repository

Documentation

View on GitHub

From the project's GitHub README.

CityEngine Cloud MCP Server & Tools

Text-to-3D city buildings in one sentence: natural language → CGA rules → cloud engine → glTF/glb — plus demo browsing and quota lookup. Read-only compute endpoints only.

This repository contains two complementary packages:

PackageWhat it isUse it with
cityengine-mcp (repo root)MCP server (stdio, FastMCP)kimi code, Codex CLI, Claude Desktop, any MCP client
cityengine-tools/OpenAI-compatible function-calling toolkit (schemas + client)DeepSeek, Qwen, GLM, GPT and any OpenAI-style tool-calling API

Live demos and self-service API keys: https://www.cityengine.cn/plugins.html · API contract: https://api.cityengine.cn

Tools (6)

ToolDescriptionQuota
generate_cgaNatural language → CGA rule source (sync, no rendering); supports base_cga + instruction refinementNL quota
parse_cgaCGA source + attributes → engine parse → 3D model stats + glb download (sha256 verified)generate quota
generate_modelNatural language → ready 3D model (NL2CGA + parse chained), returns cga_source tooNL + generate
list_demosList showcase demos on the official site (id/name/engine/attribute count)free
get_demoInspect a demo's attribute panel, node/material counts, engine timingfree
get_quotaCurrent key's plan and quota usagefree

All endpoints are read-only compute calls — nothing writes to your account or the site.

Install (MCP server)

pip install cityengine-mcp        # or: pip install .  from this repo
# provides the `cityengine-mcp` console script; or run: python -m cityengine_mcp.server

Requirements: Python ≥ 3.10, mcp 1.x, httpx.

Get an API key

Keys use the cvk_ prefix. Two self-service ways:

  1. Website: register/log in at https://www.cityengine.cn → User Center → "插件 Key" → issue (shown once, save it).
  2. CLI:
curl -X POST https://api.cityengine.cn/v1/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"strong-password","nickname":"optional"}'
# the response api_key is your plugin key (shown in full only once)

Free tier: 5 NL generations/month, 100 model generations/day. Paid members: unlimited NL.

Configure your MCP client

Environment variables:

VariableRequiredDefaultPurpose
CITYENGINE_API_KEYyes—plugin API key (cvk_…)
CITYENGINE_GATEWAY_BASEnohttps://api.cityengine.cngateway base URL
CITYENGINE_DEMOS_BASEnohttps://www.cityengine.cndemo listing site
CITYENGINE_OUTPUT_DIRno./cityengine_mcp_outputwhere glb files land
CITYENGINE_MAX_POLL_Sno300render job poll cap (seconds)

Generic MCP client config:

{
  "mcpServers": {
    "cityengine": {
      "command": "python",
      "args": ["-m", "cityengine_mcp.server"],
      "env": { "CITYENGINE_API_KEY": "cvk_xxx" }
    }
  }
}

Ready-made snippets for kimi code, Codex CLI and Claude Desktop live in config-examples/.

OpenAI-compatible function calling (cityengine-tools/)

pip install ./cityengine-tools
from cityengine_tools import CityEngineTools
tools = CityEngineTools(api_key="cvk_xxx")
# pass tools.schemas() as the `tools` parameter of any OpenAI-compatible chat call;
# feed tool_calls back into tools.dispatch(...) to execute them.

JSON schemas for all six tools are in cityengine-tools/schemas/.

Links

License

MIT (see LICENSE). The packages are client SDKs; generated models and CGA output are governed by your cityengine.cn plan terms.

Reviews

No reviews yet

Be the first to review this server!