Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.
Python aecai-agentsautodeskautomationbimclaudeifcmcpmcp-servermodel-context-protocolnavisworksrevitrevit-addinrevit-apirhino
#!/usr/bin/env python3
"""Generate docs/images/readme/works-with.svg: what AEC Model Bridge works with.
python3 docs/design/readme-visuals/make_works_with.py
A terminal-style card. Brand marks come from Simple Icons (CC0,
https://simpleicons.org). A tool without an official mark there is listed as text,
never with an invented logo. Product names and logos belong to their owners.
Edit ROWS to change the content, then run this script. Do not edit the SVG by hand.
"""
import html
import os
OUT = os.path.join(os.path.dirname(__file__), "..", "..", "images", "readme", "works-with.svg")
ICONS = {
"anthropic": "M17.3041 3.541h-3.6718l6.696 16.918H24Zm-10.6082 0L0 20.459h3.7442l1.3693-3.5527h7.0052l1.3693 3.5528h3.7442L10.5363 3.5409Zm-.3712 10.2232 2.2914-5.9456 2.2914 5.9456Z",
"autodesk": "m.129 20.202 14.7-9.136h7.625c.235 0 .445.188.445.445 0 .21-.092.305-.21.375l-7.222 4.323c-.47.283-.633.845-.633 1.265l-.008 2.725H24V4.362a.561.561 0 0 0-.585-.562h-8.752L0 12.893V20.2h.129z",
"rhino": "M6.823 3.103c-.1 0-.213.006-.34.017-.511.044-1.25.18-1.802.329a6.269 6.269 0 0 0-1.15.42c-.231.112-.33.178-.354.273-.023.094.028.217.16.436s.346.533.535.961c.19.428.356.97.361 1.651.006.68-.149 1.5-.245 1.962-.096.462-.133.568-.227.618-.094.05-.245.044-.525-.021-.281-.065-.69-.187-1.1-.259-.41-.072-.819-.093-1.122-.038-.304.056-.504.189-.645.369-.14.18-.224.406-.282.75A6.957 6.957 0 0 0 0 11.687c.005.317.047.49.136.584.088.094.223.109.492.054s.672-.18 1.224-.215a6.302 6.302 0 0 1 1.94.202c.685.182 1.353.49 1.95.93.598.438 1.127 1.007 1.566 1.593.438.586.787 1.189 1.004 1.541.217.353.304.455.372.42.068-.035.117-.207.145-.417a3.141 3.141 0 0 0-.02-.848 7.467 7.467 0 0 0-.32-1.365 5.617 5.617 0 0 0-.495-1.018c-.146-.247-.241-.408-.245-.51-.004-.103.085-.148.51-.315.424-.167 1.185-.457 1.958-.808.772-.351 1.556-.764 2.042-1.106.486-.341.674-.61.724-.937.05-.326-.039-.71-.16-1.076a6.93 6.93 0 0 0-.529-1.193A13.696 13.696 0 0 0 11.28 5.6a9.187 9.187 0 0 0-1.1-1.236c-.282-.255-.421-.31-.51-.29-.09.02-.131.115-.168.47-.037.356-.07.973-.144 1.559a7.468 7.468 0 0 1-.432 1.773 12.543 12.543 0 0 1-.99 1.982c-.388.64-.803 1.212-1.054 1.462-.25.25-.336.18-.477.064l-.486-.4c-.15-.125-.253-.213-.273-.293-.02-.08.045-.15.27-.448.227-.299.615-.825.96-1.478a7.75 7.75 0 0 0 .796-2.282 10.1 10.1 0 0 0 .095-2.338c-.044-.564-.124-.77-.306-.896-.137-.095-.332-.146-.638-.146zm6.48 7.034h-.012c-.084.01-.192.112-.415.294a6.86 6.86 0 0 1-1.017.7c-.458.257-1.038.507-1.51.734-.47.226-.831.429-1.004.712-.172.283-.155.648.04.85.194.204.566.246.883.259.318.013.58-.002.826.087.246.09.475.285.764.516.288.23.637.498.925.561.289.063.518-.079.766-.202.249-.124.516-.23.888-.225.371.005.847.12 1.318.37.47.248.938.63 1.184.866.247.236.272.327.245.362-.028.036-.108.018-.304-.14-.196-.157-.508-.454-.917-.688-.41-.234-.916-.404-1.4-.391-.482.013-.94.21-1.23.55-.29.34-.412.822-.546 1.164-.133.341-.28.543-.47.617-.19.074-.424.02-.703-.099-.28-.12-.604-.307-.874-.442-.269-.136-.484-.22-.62-.353-.136-.132-.195-.31-.203-.571-.01-.26.032-.6.05-.853.02-.25.018-.413-.038-.56a1.079 1.079 0 0 0-.232-.35c-.07-.07-.099-.075-.113-.058-.014.017-.012.058.01.158.023.1.067.26.05.581-.019.321-.098.803-.16 1.17-.062.366-.107.618-.02.808.087.191.306.322.707.54.4.22.982.527 1.518.855.537.327 1.027.673 1.562 1.089.534.415 1.112.9 1.5 1.238.39.339.588.532.742.59.154.059.264-.018.307-.138.044-.12.023-.285-.014-.429a1.174 1.174 0 0 0-.24-.46 4.92 4.92 0 0 0-.68-.704c-.287-.243-.614-.463-.803-.614-.19-.151-.242-.233-.212-.259.03-.026.14.004.302.108.162.103.375.28.612.459.237.178.499.356.733.584.235.228.443.506.583.706.14.201.214.324.294.372.08.049.165.022.277-.05a3.03 3.03 0 0 0 .426-.355c.178-.169.398-.393.551-.633.154-.24.242-.496.299-.772.056-.276.08-.572.247-.862.167-.29.476-.574.994-1.025.518-.451 1.244-1.07 1.891-1.664.648-.595 1.216-1.165 1.696-1.802.479-.638.87-1.342 1.067-1.743.199-.4.205-.498.14-.526-.063-.027-.198.015-.61.313-.414.297-1.106.849-1.886 1.43-.781.58-1.65 1.19-2.336 1.569-.686.378-1.19.524-1.55.562-.361.037-.58-.034-.724-.11-.143-.077-.21-.158-.224-.241-.013-.084.03-.17.135-.275.106-.106.277-.232.447-.392.17-.16.338-.354.468-.556.13-.202.22-.411.261-.592.042-.181.034-.333-.04-.376-.074-.043-.215.023-.376.11-.162.086-.343.192-.593.3a2.683 2.683 0 0 1-.92.235 1.626 1.626 0 0 1-1.088-.313c-.343-.26-.635-.71-.866-1.147-.23-.438-.398-.865-.512-1.12-.108-.242-.168-.33-.246-.33zm-2.215 4.075a.422.422 0 0 0-.294.115c-.094.086-.145.2-.034.338.112.137.385.297.636.469.252.172.481.357.666.42.184.064.323.006.402-.096.08-.102.1-.247-.003-.404-.103-.157-.327-.325-.564-.481-.238-.157-.488-.302-.681-.346a.574.574 0 0 0-.128-.015zm.252.208c.025 0 .053.003.083.01.118.026.272.115.418.211.145.096.283.2.333.289.05.089.014.163-.048.216a.255.255 0 0 1-.247.053c-.1-.031-.216-.126-.36-.219-.145-.093-.319-.184-.387-.268-.068-.084-.031-.162.029-.218a.26.26 0 0 1 .18-.074zm4.778 3.728c.211-.008.42.06.602.24.183.178.34.467.383.732.042.265-.03.505-.125.692a1.58 1.58 0 0 1-.289.397c-.074.074-.109.095-.14.095h-.003c-.033-.001-.062-.023-.208-.171a7.39 7.39 0 0 1-.573-.642c-.165-.22-.232-.383-.263-.568-.032-.185-.027-.39.082-.536.109-.146.323-.23.534-.239zm.093 1.111a.258.258 0 0 0-.153.046c-.058.041-.105.113-.093.185.012.073.085.146.174.255.089.11.195.255.264.335.068.08.1.093.127.091.029-.002.054-.018.086-.048a.349.349 0 0 0 .094-.157.518.518 0 0 0 .002-.316.668.668 0 0 0-.218-.282.476.476 0 0 0-.283-.109z",
"mcp": "M13.85 0a4.16 4.16 0 0 0-2.95 1.217L1.456 10.66a.835.835 0 0 0 0 1.18.835.835 0 0 0 1.18 0l9.442-9.442a2.49 2.49 0 0 1 3.541 0 2.49 2.49 0 0 1 0 3.541L8.59 12.97l-.1.1a.835.835 0 0 0 0 1.18.835.835 0 0 0 1.18 0l.1-.098 7.03-7.034a2.49 2.49 0 0 1 3.542 0l.049.05a2.49 2.49 0 0 1 0 3.54l-8.54 8.54a1.96 1.96 0 0 0 0 2.755l1.753 1.753a.835.835 0 0 0 1.18 0 .835.835 0 0 0 0-1.18l-1.753-1.753a.266.266 0 0 1 0-.394l8.54-8.54a4.185 4.185 0 0 0 0-5.9l-.05-.05a4.16 4.16 0 0 0-2.95-1.218c-.2 0-.401.02-.6.048a4.17 4.17 0 0 0-1.17-3.552A4.16 4.16 0 0 0 13.85 0m0 3.333a.84.84 0 0 0-.59.245L6.275 10.56a4.186 4.186 0 0 0 0 5.902 4.186 4.186 0 0 0 5.902 0L19.16 9.48a.835.835 0 0 0 0-1.18.835.835 0 0 0-1.18 0l-6.985 6.984a2.49 2.49 0 0 1-3.54 0 2.49 2.49 0 0 1 0-3.54l6.983-6.985a.835.835 0 0 0 0-1.18.84.84 0 0 0-.59-.245",
}
# (section label or None, [(icon key or None, label, note or None)])
ROWS = [
("ai-clients", [("anthropic", "Claude Desktop", None), (None, "VS Code + Copilot", None), (None, "Cursor", None), (None, "Codex", None)]),
("also-mcp", [("anthropic", "Claude Code", None), (None, "Windsurf", None), (None, "Cline", None), (None, "Continue", None), (None, "Zed", None), (None, "Gemini CLI", None)]),
("applications", [("autodesk", "Revit 2024-2027", None), ("rhino", "Rhino", None), (None, "Grasshopper", None), (None, "Navisworks", "in progress")]),
("data", [(None, "IFC", None), (None, "Speckle", None), (None, "Excel", None), (None, "SQLite", None)]),
("protocol", [("mcp", "MCP", None), (None, "stdio", None), (None, "approval gate", None)]),
]
W = 1200
ROW_H = 48
TOP = 150
H = TOP + ROW_H * len(ROWS) + 70
CHAR = 10.4
INK = "#E8EEFC"
TEAL = "#5EE9D3"
MUTED = "#6B7FA3"
def icon(key, x, y, size=22):
return (f'<path transform="translate({x} {y}) scale({size / 24:.4f})" '
f'd="{ICONS[key]}" fill="{INK}"/>')
def build():
out = [f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {W} {H}" role="img" aria-labelledby="t">',
'<title id="t">AEC Model Bridge has documented setup for Claude Desktop, VS Code with GitHub Copilot, Cursor and Codex, and should work with other MCP clients such as Claude Code, Windsurf, Cline, Continue, Zed and Gemini CLI; with Revit 2024 to 2027, Rhino, Grasshopper and Navisworks (in progress); with IFC, Speckle, Excel and SQLite; over MCP stdio with an approval gate.</title>',
'<defs><linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#060a13"/><stop offset="1" stop-color="#0b1424"/></linearGradient>'
f'<clipPath id="c"><rect width="{W}" height="{H}" rx="20"/></clipPath></defs>',
'<style>text{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,"DejaVu Sans Mono",monospace}</style>',
f'<g clip-path="url(#c)"><rect width="{W}" height="{H}" fill="url(#bg)"/>',
f'<rect x="40" y="30" width="{W - 80}" height="{H - 60}" rx="14" fill="#0a111f" stroke="#243247"/>',
f'<path d="M40 44a14 14 0 0 1 14-14h{W - 108}a14 14 0 0 1 14 14v28H40z" fill="#0f1a30"/>',
f'<line x1="40" y1="72" x2="{W - 40}" y2="72" stroke="#243247"/>',
'<circle cx="68" cy="51" r="6.5" fill="#ff5f57"/><circle cx="90" cy="51" r="6.5" fill="#febc2e"/><circle cx="112" cy="51" r="6.5" fill="#28c840"/>',
f'<text x="{W // 2}" y="56" text-anchor="middle" font-size="14" fill="{MUTED}">aec-model-bridge ~ works-with.toml</text>',
f'<text x="72" y="116" font-size="17" fill="{MUTED}">$</text><text x="92" y="116" font-size="17" fill="{INK}">cat works-with.toml</text>']
y = TOP
for section, items in ROWS:
if section:
out.append(f'<text x="72" y="{y + 24}" font-size="18" fill="{TEAL}">[{html.escape(section)}]</text>')
x = 330
for key, label, note in items:
if key:
out.append(icon(key, x, y + 6))
tx = x + 32
else:
tx = x
out.append(f'<text x="{tx}" y="{y + 24}" font-size="18" fill="{INK}">{html.escape(label)}</text>')
width = len(label) * CHAR
if note:
out.append(f'<text x="{tx + width + 8}" y="{y + 24}" font-size="13" fill="{MUTED}">({html.escape(note)})</text>')
width += len(note) * 7.8 + 28
x = tx + width + 34
y += ROW_H
out.append(f'<text x="72" y="{y + 30}" font-size="17" fill="{MUTED}">$</text>')
out.append(f'<rect x="92" y="{y + 16}" width="10" height="20" fill="{TEAL}"/>')
out.append('</g></svg>')
return "\n".join(out) + "\n"
if __name__ == "__main__":
path = os.path.normpath(OUT)
with open(path, "w", encoding="utf-8", newline="\n") as f:
f.write(build())
print("wrote", path)