convez.ai
MCP ServerAutomaçãoIntermediário
studioliquid-lab

Gerador de Ferramentas MCP para Revit

studioliquid-lab/revit-mcp-tool-generator

Crie ferramentas Revit falando com Claude, sem código

Ver no GitHub
InicialPluginScore · de 0 a 100

Gera ferramentas MCP para Revit a partir de linguagem natural usando Claude e pyRevit, sem necessidade de código ou conhecimento da API. Descreva o que deseja, Claude cria, testa e instala a ferramenta automaticamente no seu projeto Revit.

Instalação

$npx convez-ai studioliquid-lab/revit-mcp-tool-generator

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
62%
Último commit
há 5 meses
Versão
v0.1.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar tarefas repetitivas em modelos Revit via linguagem natural
  • Gerar scripts para listar, filtrar e modificar elementos arquitetônicos
  • Criar e compartilhar ferramentas customizadas com equipes de projeto

Veredito

Projeto experimental promissor que democratiza a automação em Revit para não-programadores. Funciona bem em Revit 2024, mas ainda carece de testes em versões anteriores e é adequado apenas para projetos de teste, não produção.

README

A tradução para o português deste README ainda está na fila.

revit-mcp-tool-generator

🇬🇧 English · 🇮🇹 Italiano

Build MCP tools for Revit by talking to Claude in plain language. No code, no Revit API knowledge needed — describe what you want, Claude builds it, tests it, installs it.

License: MIT Status: experimental Tested on: Revit 2024 Tests: 79


⚠️ Project Status

This is an experimental project in early stages (v0.1.0). We built it at Studioliquid to solve an internal workflow need at our studio, and decided to open source it to gather feedback from the Revit community.

What that means in practice:

  • ✅ The 49 backend unit tests pass
  • ✅ The end-to-end flow has been verified only on Revit 2024 with pyRevit Master
  • ⚠️ NOT tested on other Revit versions (2022/2023/2025+). It might work, but no guarantees
  • ⚠️ Bugs and edge cases are expected: not battle-tested
  • ⚠️ Internal APIs and patterns may change in upcoming releases (semver < 1.0)
  • ⚠️ Use on test projects first, not production models

Tested versions

ComponentVersion tested
Revit2024 (build 2024.2)
pyRevitMaster (4.8.16+)
Python (host of the MCP server)3.11 / 3.14
Operating systemWindows 11

If you try it on other versions, open an Issue and let us know how it went — good or bad experience is valuable to expand the compatibility matrix.

We're actively looking for feedback on:

  • Bugs, crashes, Revit instability
  • Tools that the skill can't generate (or generates incorrectly)
  • Suggestions to improve the cookbook and templates
  • Workflows and use cases you'd like to see supported

Open an Issue or join the Discussions.


What it does

In Claude, you write (in any language):

I want a tool that lists all walls on the active level with their thickness in millimeters.

Claude:

  1. Checks whether a similar tool already exists
  2. Generates pyRevit handler code + MCP manifest
  3. Validates the code via pyRevit
  4. Installs it in your personal library
  5. Tests it immediately on the open Revit project
  6. Shows you the result

20-40 seconds from prompt to working, persistent, reusable tool — shareable with colleagues.

Examples of tools you can generate

  • "Count the elements in my current selection and tell me their categories"
  • "List the doors on the active level with their dimensions"
  • "On the selected walls, set the comment to the text I pass"
  • "Delete walls below a given height — show me a preview first"

Architecture

┌──────────────────────┐     MCP      ┌──────────────────────┐     HTTP     ┌────────────────────┐
│  Claude (Code/Desktop)│ ◀─stdio─▶ │  revit-mcp-server    │ ◀──REST───▶ │  Revit + pyRevit   │
│  + skill              │            │  (local Python)      │              │  (Routes server)   │
└──────────────────────┘             └──────────────────────┘              └────────────────────┘
        ↓                                       ↑
   "I want a tool that..."             ~/.revit-mcp/tools/
                                        (global library)

Three components, each with a single responsibility:

  1. pyRevit extension RevitMcpRoutes — exposes HTTP routes inside Revit for managing the tool library
  2. revit-mcp-server (Python) — MCP server that proxies between Claude and pyRevit
  3. Skill revit-mcp-tool-generator — markdown content that teaches Claude how to generate safe, working tools

Generated tools are (manifest.json, handler.py) pairs saved both in ~/.revit-mcp/tools/ (user library) and in RevitMcpRoutes.extension/lib/revit_mcp_routes/tools/.


Install

Five minutes on Windows.

Prerequisites

  • Windows 10/11 with PowerShell 5+
  • Revit 2024 ⚠️ (the only tested version; other versions may work but are not officially supported)
  • pyRevit 4.8+ (download)
  • Python 3.11+ (download)
  • Claude Code (CLI) or Claude Desktop App (download)

Quick install

  1. Download the latest release from the Releases page (a single .zip)
  2. Extract to a stable folder (e.g. C:\Tools\revit-mcp-tool-generator\)
  3. Double-click setup.bat
  4. Restart Revit + Claude
  5. In Claude write: "Use the sample_read tool and tell me how many walls you find" → verify it works

Detailed instructions: see INSTALL.md (Italian) — English translation coming soon.


Sharing tools with the community

Each tool is two files. To package it:

.\export-tool.ps1 -Name list_walls_by_level

Output: list_walls_by_level.tool.zip (~1-2 KB), shareable via email/cloud. A colleague imports it with:

.\import-tool.ps1 -Zip "list_walls_by_level.tool.zip"

The import script validates the tool on the destination machine before installing.


Known limitations

  • Windows only: Revit only runs on Windows
  • Hot-reload of new tools in Claude Desktop App: client-side limitation (Code CLI works perfectly, Desktop App requires restart after each new tool)
  • Single Revit version per install: to change Revit version, edit ~/.revit-mcp/config.toml or re-run setup.bat
  • Python 3.11+ required for the MCP server (pyRevit uses IronPython 2.7 but is handled automatically)

Documentation

DocumentContent
INSTALL.mdInstallation guide and troubleshooting (Italian)
docs/user/setup.mdQuickstart
docs/user/portable-skill.mdUse the skill with non-Claude agents (ChatGPT, Cursor, etc.)
docs/user/install-extension.mdManual installation of the pyRevit extension only
docs/user/configure-claude-code.mdManual Claude Code configuration
revit-mcp-tool-generator/SKILL.mdSkill content (entry point for Claude)
revit-mcp-tool-generator/references/cookbook.md15 tested pyRevit patterns
revit-mcp-tool-generator/references/api-quickref.mdRevit API quick-reference

Note: Most internal documentation is currently in Italian. PRs translating docs to English are very welcome.


Contributing

See CONTRIBUTING.md. The most valuable contributions are:

  • Issues describing tools the skill cannot generate
  • Pull requests adding patterns to the cookbook
  • Use case stories in Discussions: what works well, what doesn't, what's missing

Roadmap

See CHANGELOG.md for release history and intent.

Areas of future exploration (ordered by likelihood):

  • v0.2: local LLM wiki of Revit docs (replaces on-demand WebFetch, works offline)
  • v0.3: simultaneous multi-version Revit
  • v0.4: composite tools (macros that call other tools)
  • v1.0: API stabilization + community tool marketplace

License

MIT — copyright © 2026 Studioliquid

See NOTICE.md for third-party software credits and trademark attributions (Autodesk® Revit®, Anthropic Claude™, pyRevit, Python packages used at runtime).


Built and maintained by Studioliquid — an Italian studio working at the intersection of architecture, BIM, and AI.

Ver o original no GitHub

Bom para

Relacionados