Revit MCP Server

An MCP server for integrating AI with Autodesk Revit, enabling seamless communication via WebSocket.

GitHub

πŸ—οΈ 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
  1. Monitor WebSocket communication with Revit plugin
  2. 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:

Related Servers