What can you do with this server?

The Revit MCP Server serves as a bridge enabling Claude AI to interact with Autodesk Revit models in real-time via WebSocket connections. Key capabilities: * 🔌 Real-time Communication: WebSocket-based connection for live model interactions * 📊 Model Information: Access metadata, element counts, and model state * 🏗️ Element Management: Query, filter, and manage elements with their properties and geometry * 🎪 View & Level Control: Navigate through and list views and levels * 📚 Schema Operations: Retrieve categories, families, elements, and detailed information * ⚙️ Customizable: Configure connection settings via environment variables * 📡 Error Handling: Fall back to mock data when Revit connection is unavailable

Which integrations are available for this server?

Provides real-time access to Revit model information, element querying and filtering, view and level management, and model metadata access through a WebSocket connection with the Revit plugin.

How do I use Revit MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Revit MCP Server show me all the doors in the current model" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

The Revit MCP Server serves as a bridge enabling Claude AI to interact with Autodesk Revit models in real-time via WebSocket connections.

Key capabilities:

🔌 Real-time Communication: WebSocket-based connection for live model interactions
📊 Model Information: Access metadata, element counts, and model state
🏗️ Element Management: Query, filter, and manage elements with their properties and geometry
🎪 View & Level Control: Navigate through and list views and levels
📚 Schema Operations: Retrieve categories, families, elements, and detailed information
⚙️ Customizable: Configure connection settings via environment variables
📡 Error Handling: Fall back to mock data when Revit connection is unavailable

🏗️ 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

Related MCP server: QGISMCP

✨ 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:

Use the built-in MCP Inspector:

npm run inspector

Monitor WebSocket communication with Revit plugin
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: 353554036@qq.com
💬 WeChat Account: modian4500

Revit MCP Server