OmniBridge MCP
# OmniBridge MCP
**One MCP server. Every scriptable CAD, BIM and 3D app. Any AI model.**
OmniBridge lets Claude, ChatGPT, Gemini, Cursor, Copilot or a local model work inside
the design software on your PC: read the model, draw, edit, check, and look at the
result. It speaks the [Model Context Protocol](https://modelcontextprotocol.io), so any
MCP client can use it.
```
Claude / ChatGPT / Gemini / Cursor / local model
| MCP (stdio or HTTP)
OmniBridge server 5 tools, the same for every app
|
+----------------+-----------------+----------------------+
| in-app bridge | automation | the app's own channel|
| (script runs | (COM / .NET / | (pyRevit Routes, |
| inside) | JSON API) | Unreal remote exec) |
+----------------+-----------------+----------------------+
Blender, Rhino, AutoCAD, SOLIDWORKS, Revit, Unreal
3ds Max, SketchUp Archicad, Navisworks,
FreeCAD, Maya ... Inventor, Tekla ...
```
## The idea
pyRevit gave Revit a door for scripts. Tapir did the same for Archicad. OmniBridge
applies that one principle everywhere: **do not wrap each app in hundreds of fixed
tools; give the model a way to run a short script in the app, and a guide for writing
that script well.**
So the server has five tools, whatever the app:
| Tool | What it does |
|---|---|
| `cad_apps` | lists every supported app and whether it is reachable right now |
| `cad_skill` | returns the scripting guide for one app: language, predefined names, units, recipes, traps |
| `cad_read` | runs a script that only inspects the model |
| `cad_modify` | runs a script that changes the model, as one undo step where the app allows |
| `cad_screenshot` | returns a picture of the app's viewport or window so the model can check its work |
Reading and changing are separate tools on purpose: MCP clients can auto-approve the
first and ask you before the second.
## Supported apps
"Tested" means the authors ran it end to end. Everything else is written against the
vendor's documented API and needs a first real run: please report what you find.
| App | How it connects | Script language | Status |
|---|---|---|---|
| **AutoCAD** (+ Civil 3D, Plant 3D, Map 3D, MEP) | COM automation, nothing to install | Python | **Tested** (AutoCAD 2024) |
| BricsCAD, ZWCAD, GstarCAD, nanoCAD | COM automation (AutoCAD-compatible) | Python | Untested |
| **Revit** | pyRevit extension (Routes) | Python (Revit API) | **Tested** (Revit 2026) |
| **Archicad** | JSON API + Tapir add-on | Python + `ac` helper | **Tested** (Archicad 29) |
| **Navisworks** Manage / Simulate | COM automation (legacy API) | Python | Experimental |
| **Rhino** 7 / 8 / 9 + Grasshopper | in-app Python bridge | Python | Untested |
| **3ds Max** 2021+ | in-app pymxs bridge | Python + MAXScript | Untested |
| **SketchUp** 2021+ | in-app Ruby bridge | Ruby | Untested |
| **Blender** 3.2+ | add-on | Python (bpy) | **Tested** (Blender 5.2) |
| FreeCAD 0.21+ | Mod folder bridge | Python | Untested |
| Autodesk Fusion | add-in | Python (adsk) | Untested |
| **SOLIDWORKS** | COM automation, nothing to install | Python | **Tested** (SOLIDWORKS 2025) |
| Inventor, CATIA V5, Solid Edge | COM automation | Python | Untested |
| MicroStation | COM automation | Python | Untested |
| Tekla Structures | Open API through pythonnet | Python | Untested |
| ETABS, SAP2000, Robot | COM automation | Python | Untested |
| Maya, Cinema 4D, Houdini | in-app Python bridge | Python | Untested |
| **Unreal Engine 5** | built-in Python remote execution | Python | **Tested** (UE 5.8) |
| QGIS 3.28+ / 4 | plugin | Python (PyQGIS) | Untested |
**Not possible today** (no scripting interface of any kind): Twinmotion, Lumion,
D5 Render, Enscape, Shapr3D, Plasticity, AutoCAD LT (no external automation),
Navisworks Freedom. Vectorworks, Allplan and NX only allow in-process plug-ins and are
on the roadmap.
## Install
Needs Windows and Python 3.10+ ([uv](https://docs.astral.sh/uv/) recommended).
```bash
uv tool install git+https://github.com/ayoubmep/omnibridge-mcp
```
or from a clone:
```bash
pip install -e .
```
Check what it can see:
```bash
omnibridge apps
```
### Connect your AI client
```bash
omnibridge config claude-desktop
```
prints the exact snippet for your machine. Replace the name with `claude-code`,
`cursor`, `vscode`, `gemini`, `codex`, `lmstudio`, `chatgpt` or `all`.
Details and caveats per client: [docs/clients.md](docs/clients.md).
### Connect your apps
Apps driven by automation (AutoCAD, SOLIDWORKS, Archicad, Tekla ...) need nothing:
start the app and open a file.
Apps that need a bridge inside them get it with one command:
```bash
omnibridge install blender
```
Use `rhino`, `3dsmax`, `sketchup`, `freecad`, `fusion`, `maya`, `c4d`, `houdini`,
`qgis`, `revit`, or `all` for every app found on the PC. The command prints the one
manual step some apps still need (ticking the add-on, pasting a startup line).
`omnibridge uninstall <app>` removes it again.
## Try it
Ask your AI client:
> Use OmniBridge. Which CAD apps are open? In AutoCAD, draw a 6 x 4 m room on a new
> layer "A-WALL" with a 900 mm door opening on the south wall, then show me a
> screenshot.
More prompts, including cross-app ones: [examples/prompts.md](examples/prompts.md).
You can also drive an app from the terminal, which is handy for debugging:
```bash
omnibridge run autocad "result = {'file': doc.Name, 'entities': ms.Count}"
```
## Safety
Giving an AI a script engine inside your design software is powerful. Treat it that way.
- **Local only.** Bridges listen on `127.0.0.1` and refuse any request without the
secret token stored in `~/.omnibridge/token`. A web page cannot read that file and
cannot talk to the bridge.
- **Scripts are not sandboxed.** A script can do anything the app can do, including
deleting geometry and writing files. Keep your client's approval prompt on for
`cad_modify`, work on a copy of important models, and save before a session.
- **One undo step.** Where the app supports it, each `cad_modify` is a single undo
entry named after what the AI said it was doing.
- **HTTP mode is for trusted networks.** `omnibridge serve --transport http` has no
login of its own. If you expose it through a tunnel for ChatGPT, use a tunnel that
requires authentication and stop it afterwards.
- **Revit:** pyRevit Routes itself has no authentication; OmniBridge's endpoints check
the token, other Routes endpoints on your machine do not.
## How it works
- [docs/protocol.md](docs/protocol.md): the wire protocol and how to add an app (about
60 lines of code for an app with a Python console).
- [docs/prior-art.md](docs/prior-art.md): the existing MCP servers for each app, the
vendors' own servers, and how OmniBridge differs. If one app is all you need, one of
those dedicated servers may suit you better.
- [docs/status.md](docs/status.md): exactly what has been tested, and on what.
## Credits
OmniBridge stands on the ideas of [pyRevit](https://github.com/pyrevitlabs/pyRevit),
[Tapir](https://github.com/ENZYME-APD/tapir-archicad-automation),
[blender-mcp](https://github.com/ahujasid/blender-mcp),
[rhinomcp](https://github.com/jingcheng-chen/rhinomcp) and the many projects listed in
[docs/prior-art.md](docs/prior-art.md). No code from them is included.
## License
MIT. See [LICENSE](LICENSE).
TDQS
Scored across 5 tools
Each tool has a clearly distinct role: discovery, documentation, read-only execution, modifying execution, and visual verification. The read/modify split is explicitly differentiated by intent and side effects, leaving little chance of misselection.
All tools share a consistent 'cad_' namespace and are concise and readable. However, the suffixes mix nouns (apps, skill, screenshot) with verbs (read, modify), so the pattern is not a pure verb_noun convention.
Five tools is well-scoped for a CAD bridge: discover apps, read the scripting guide, inspect, modify, and visually verify. Each tool clearly earns its place with no redundant surface area.
The surface covers the full core workflow: app availability, scripting guidance, read-only inspection, model mutation with undo support, and screenshot verification. No obvious lifecycle gaps remain, and fallback paths are noted where capabilities vary by app.