MCP server for natural-language querying of 3DCityDB v5 semantic city models
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"3dcitydb-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# 3DCityDB MCP Server A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives AI assistants direct, natural language access to the **3DCityDB v5**. It dynamically resolves object classes, properties, codelists, and generic attributes from the database so the AI can answer spatial questions, write and execute SQL queries, and reason about CityGML data — without any manual prompt engineering. --- ## Features - **Dynamic schema resolution** — walks the CityGML class hierarchy to discover available object classes and their properties - **Property filtering** — only includes properties that actually exist in the database - **Codelist resolution** — fetches code meanings only for codes present in the DB - **Generic attribute enrichment** — automatic categorical detection for generic attributes - **Read-only query execution** — `run_query` enforces SELECT-only; writes are blocked - **Prompt assembly** — `assemble_prompt` orchestrates all tools into a complete system prompt in one call - **Gradio chat UI** — browser-based interface with multi-LLM support (Anthropic, OpenAI, Ollama) - **CityGML import** — one-click import via the Gradio UI (fullstack Docker mode only) --- ## Deployment Options There are three ways to run the 3DCityDB MCP Server: | | Option 1: PyPI | Option 2: Docker BYOD | Option 3: Docker Fullstack | |---|---|---|---| | **Best for** | Claude Code / Claude Desktop power users | Existing 3DCityDB instances | Starting from a `.gml` file | | **Requires** | Python 3.10+, running 3DCityDB | Docker, running 3DCityDB | Docker only | | **Gradio UI** | No (uses your AI client directly) | Yes (`localhost:7860`) | Yes (`localhost:7860`) | | **CityGML import** | Manual | Manual | Via Gradio UI | | **Database** | Your own | Your own | Bundled (PostgreSQL + PostGIS + SFCGAL) | --- ## Option 1: PyPI Package Install the MCP server as a Python package and connect it to Claude Code, Claude Desktop, or any MCP-compatible client. ### Pr…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.