revit_mcp
If you are the rightful owner of revit_mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol server for Revit integration, enabling seamless communication between Claude AI and Autodesk Revit.
๐๏ธ 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:
- ๐ฌ WeChat Account: modian4500
