Skip to main content
Glama
Renga–Codex Bridge

Renga–Codex Bridge

by ucrdaniel

Renga–Codex Bridge

Independent, unofficial local MCP integration for Codex and Renga BIM. Codex interprets the task; this package provides typed COM operations, geometry, native documentation and saved-result verification. No AI API key, second agent service or design chat application is required.

0.2.0 preview — verified subset for Renga Professional 9.3.32980.0. Real local CLI and MCP scenarios create and edit native BIM objects, then save, close, reopen and check the requested values. See the scoped native evidence and testing instructions; hosted CI does not run Renga. Computer Use and mouse/keyboard emulation are prohibited for advertised API coverage. Renga and its SDK must be installed/licensed separately. No vendor binaries, SDK-generated wrappers, private models or credentials are shipped.

Installation

Windows x64, Python3.11+, installed Renga and separately downloaded SDK:

.\scripts\install.ps1 -PythonExe 'C:\path\to\python.exe' -SdkPath 'C:\path\to\RengaSDK'

Read Russian installation or English installation, capabilities, previous work analysis and repository research.

Related MCP server: mcp-server-for-revit

Architecture

flowchart LR
    Codex --> MCP[stdio MCP server]
    MCP --> Worker[serialized isolated STA worker]
    Worker --> Adapter[typed local COM adapter]
    Adapter --> Renga[Renga-owned project process]
    Renga --> Verify[save / close / reopen / UUID and value checks]

Core modules: session/safety/audit, SDK loading, BIM operations, geometry, catalogs, native drawings/exports, verification, deterministic plan helpers. API coordinates are millimeters; area m² and volume m³ are labelled explicitly.

The 21 MCP tools cover status and capabilities; inspection and catalogs; validated plans and disposable-copy previews; geometry and area verification; project copy, SaveAs and metadata; native drawing content, PDF, IFC and view rendering; rectangle plans and facade spacing. The complete names and verified boundaries are in CAPABILITIES.md.

New in 0.2: bridge_create_levels_project creates a new native project with explicit nonzero levels and an optional orthogonal native Axis grid through the official IFC importer. Own temporary slab carriers are removed; saved native types, names, identities and elevations are checked after reopening. Axis coordinates are verified through a fresh native IFC export, because the tested Axis has no supported direct baseline getter. This bootstrap does not merge levels/axes into an existing project or move existing level elevations. The room_marker plan action positions a Room's intrinsic marker in global XY; it does not create a standalone Tag. See level/grid plans.

.\.venv\Scripts\renga-bridge.exe doctor
.\.venv\Scripts\renga-bridge.exe inspect --project 'C:\your\test-root\sample.rnp'
.\.venv\Scripts\renga-bridge.exe apply --project 'C:\your\test-root\sample.rnp' --plan examples\rectangle.json --new
python -m pytest -m 'not integration' -q

Autonomous writes are confined to RENGA_BRIDGE_WRITE_ROOT. Existing-file edits receive verified backups and native undo transactions. Dependent hosts and some calculated geometry need several applied batches before the final save; failed plans discard unsaved changes, rather than promising a single in-memory undo for every category. There is no MCP blanket authorization bypass. Copy saved user files into the dedicated working directory before editing; never run vendor sample scripts against user files.

Codex translates a task into an explicit millimeter-based JSON plan, inspects existing IDs/styles, validates the plan, optionally previews it on a copy, applies it and reads the reopened result. See operation plans. Reconnect the MCP server or start a new Codex session after installation to refresh its catalogue. Real stdio MCP and Codex discovery tests distinguish new-version coverage from historical 0.1.0 current-chat evidence; see the dated public proof.

Русский

Это инфраструктура доступа Codex к настоящей Renga через MCP и типизированный COM API. Все операции выполняются локально, без Computer Use. Публикуемое покрытие ограничено фактически проверенными возможностями. Автоматические размеры/маркеры и создание автоматических помещений нельзя имитировать текстом или изображениями. Новый проект с заданными ненулевыми уровнями и осями создаётся через bridge_create_levels_project. Изменение отметок существующих уровней по-прежнему отклоняется. Встроенный маркер помещения перемещается через room_marker; это отдельная возможность от создания нового Tag.

MIT applies to our own source. See NOTICE for third-party and Renga SDK boundaries. This project does not represent Renga Software.

Available Tools

21 tools
bridge_apply_planC

Create/edit models only under configured write root. Backup, undo transaction, save/reopen and requested-value checks included. Coordinates mm.

Inputs: project (required), operations (required), new.

bridge_capabilitiesC

Return release scope; research and actual local integration evidence are distinguished.

Inputs: no named parameters.

bridge_catalogsB

Inspect existing native styles/materials/scales/layouts/schedules before selecting actual IDs.

Inputs: project (required), collection.

bridge_copy_projectC

Copy saved native project to a NEW writable destination and open the copy in an isolated process.

Inputs: output (required), project (required).

bridge_create_drawingsC

Create actual drawings with embedded level views and optional existing native schedules/text titles; no fake dimensions or tags.

Inputs: project (required), drawings (required).

bridge_create_levels_projectB

Create a NEW native .rnp with levels at explicit elevation_mm and optional orthogonal Axis grid via official IFC import. Verify saved native identities/heights and fresh exported grid coordinates; remove own carriers. Does not modify existing level elevations.

Inputs: levels (required), project (required), grid.

bridge_export_ifcC

Export IFC4 using Renga API to a new protected output path.

Inputs: output (required), project (required).

bridge_export_pdfB

Export native drawings to one PDF using Renga API; requires a NEW output path inside write root.

Inputs: output (required), project (required), drawing_uuids.

bridge_facade_spacingB

Calculate explicit window offsets and piers in millimeters without mutating a model.

Inputs: count (required), width (required), length (required), end_pier, +1 more.

bridge_geometryC

Extract genuine native mesh vertices/triangles in millimeters.

Inputs: project (required).

bridge_inspectC

Read saved native UUIDs, parameters/definitions, quantities. Numeric IDs can change on SaveAs.

Inputs: project (required), kind, limit, offset, +1 more.

bridge_inspect_drawingsC

Read native drawing parameters and object persistent identities.

Inputs: project (required).

bridge_preview_on_copyC

Apply proposed edits to a NEW disposable native copy, preserving the saved source file.

Inputs: output (required), project (required), operations (required).

bridge_project_infoC

Read actual native project Code/Name/Stage/Description and persistent project UUID.

Inputs: project (required).

bridge_rectangle_planC

Prepare an explicit generic four-wall/room/floor operation plan. Does not mutate Renga.

Inputs: depth, width, height, thickness.

bridge_render_viewC

Render a native view through IScreenshotService; no mouse, keyboard or Computer Use calls.

Inputs: output (required), project (required), width, height, +1 more.

bridge_save_asC

Native SaveAs to a NEW protected destination; source disk file unchanged, UUIDs checked after reopen.

Inputs: output (required), project (required).

bridge_set_project_infoC

Back up, edit four native project metadata fields, save and verify after reopen; resource undo is not guaranteed.

Inputs: values (required), project (required).

bridge_statusC

Probe installed Renga in a new owned STA process; never attach to the user's session.

Inputs: no named parameters.

bridge_validate_planB

Validate plan structure without native mutation. This is NOT a native solver preview.

Inputs: operations (required).

bridge_verifyC

Compare native room/floor areas with triangle calculations and explicit targets; conservative AABB candidates only.

Inputs: project (required), expected_areas, collision_types.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

    TDQS

    B3/5.0

    Scored across 21 tools

    Disambiguation4/5

    Tool purposes are mostly distinct: plan preparation, validation, preview-on-copy, native apply, export, render, and query operations target different objects. Some ambiguity remains among read-side tools such as bridge_inspect, bridge_project_info, bridge_catalogs, and bridge_inspect_drawings, though descriptions clarify their scopes.

    Naming Consistency4/5

    All tool names use the same bridge_ prefix and snake_case style, which is highly consistent. However, the naming pattern mixes nouns, verbs, and verb_noun forms rather than following a strict verb_noun convention throughout.

    Tool Count3/5

    21 tools falls into the 16–25 range that is borderline heavy for an MCP server. While each operation is distinct and the native CAD/BIM domain is complex, the set could likely be consolidated into fewer query and plan tools.

    Completeness4/5

    The set covers read, plan, validate, preview, apply, verify, export, render, save/copy, and status operations across the native project lifecycle. Explicit delete/close operations and some direct element-editing beyond plan application are missing, but these are minor gaps for the stated bridge purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      MCP server for Autodesk Revit (BIM) with 705+ API endpoints. Enables AI agents to create walls, place doors/windows, generate sheets, manage views, and produce construction documents via the Model Context Protocol. Uses named pipes for zero-crash Revit integration.
      22
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      CAD-engineering MCP tool server for parametric modeling, DFM validation, mechanical calculations, and more. Enables code-CAD builds (build123d/CadQuery), model inspection, meshing, and mechanical calculators via MCP stdio.
      11
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects MCP clients like Claude, Codex, and Cursor to a running Autodesk Revit session for typed BIM queries, verified model edits, family authoring, exports, and Power BI workflows. It is open-source, Apache-2.0, and designed for reliable, verified outcomes.
      -