🏗️ Revit MCP Server
Revit MCP. A Model Context Protocol server for Revit integration, enabling seamless communication between Claude AI and Autodesk Revit.
What is Revit MCP?
Revit MCP is a Model Context Protocol server designed for seamless integration between Claude AI and Autodesk Revit, enabling real-time communication and interaction with Revit models.
How to use Revit MCP?
To use Revit MCP, install the necessary dependencies, configure the server settings, and run the server to establish a WebSocket connection with Revit. You can then interact with Revit models through the provided functionalities.
Key features of Revit MCP?
- Real-time access to Revit model information via WebSocket.
- Element querying and filtering capabilities.
- View and level management for better navigation.
- Robust error handling with fallback to mock data.
Use cases of Revit MCP?
- Accessing real-time model data for analysis and reporting.
- Querying specific elements within a Revit model for detailed inspection.
- Managing views and levels to enhance user experience in model navigation.
FAQ from Revit MCP?
- What are the prerequisites for using Revit MCP?
You need Node.js (v14 or higher), npm, Autodesk Revit (2023 or later), and the Revit WebSocket Plugin.
- How do I install Revit MCP?
Install dependencies using
npm install, then build the server withnpm run build.
- What happens if the connection to Revit fails?
The server automatically falls back to mock data to ensure continued operation.
🏗️ Revit MCP Server
A Model Context Protocol server for Revit integration, enabling seamless communication between Claude AI and Autodesk Revit.
🎯 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:
- 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
