What is Revit Mcp

revit_mcp is a Model Context Protocol server designed for integration with Autodesk Revit, facilitating seamless communication between Claude AI and Revit models via a WebSocket connection.

Use cases

Use cases for revit_mcp include real-time collaboration on Revit models, automated data extraction for analysis, and integration with AI tools for enhanced design insights.

How to use

To use revit_mcp, install the necessary dependencies and build the server using Node.js. Configure the server with the Revit plugin WebSocket settings, and integrate it with Claude Desktop for enhanced functionality.

Key features

Key features include real-time access to Revit model information, flexible element querying and filtering, view and level management, and robust error handling with fallback mock data.

Where to use

revit_mcp is primarily used in architecture, engineering, and construction (AEC) industries where Revit is a standard tool for building information modeling (BIM).

🏗️ Revit MCP Server

A Model Context Protocol server for Revit integration, enabling seamless communication between Claude AI and Autodesk Revit.

English | 中文

🎯 Overview

This TypeScript-based MCP server provides a bridge between Claude AI and Revit, allowing direct interaction with Revit models through a WebSocket connection. It implements the Model Context Protocol to enable:

• ⚡ Real-time access to Revit model information
• 🔍 Element querying and filtering
• 👀 View and level management
• 🛡️ Robust error handling with fallback mock data

✨ Features

🔌 Revit Integration

• 📡 WebSocket-based communication with Revit plugin
• 🔄 Real-time model data access
• 🔁 Graceful fallback to mock data when connection fails
• ⚙️ Configurable connection settings via environment variables

🚀 Core Functionalities

• 📊 Model Information

  • Access basic model metadata (name, path, version)
  • Get element counts and last modification date
  • Real-time model state synchronization

• 🏗️ Element Management

  • Query elements with flexible filtering
  • Access element properties and geometry
  • Batch element operations

• 🎪 View & Level Control

  • List all available views
  • Access level information
  • Navigate through model hierarchy

💻 Development

📋 Prerequisites

• Node.js (v14 or higher)
• npm
• Autodesk Revit (2023 or later)
• Revit WebSocket Plugin (companion plugin)

🔧 Installation

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

⚙️ Configuration

The server can be configured using environment variables:

REVIT_HOST=127.0.0.1    # Revit plugin WebSocket host
REVIT_PORT=8080         # Revit plugin WebSocket port

🔗 Integration with Claude Desktop

Add the server configuration to Claude Desktop:

Windows:

%APPDATA%/Claude/claude_desktop_config.json

Configuration format:

{
  "mcpServers": {
    "revit-mcp-server": {
      "command": "D:/path/to/revit-mcp-server/build/index.js"
    }
  }
}

🐛 Debugging

For debugging the MCP communication:

1. Use the built-in MCP Inspector:

npm run inspector

2. Monitor WebSocket communication with Revit plugin
3. Check server logs for connection and operation status

⚠️ Error Handling

The server implements robust error handling:

• Automatic fallback to mock data when Revit connection fails
• Detailed error logging
• Graceful connection recovery

📄 License

MIT License

🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests.

📬 Contact

If you have any questions or suggestions, feel free to reach out:

• 📧 Email: [email protected]
• 💬 WeChat Account: modian4500