Revitmcpserver

🚀 xml.Revit.MCP Tool Overview

English | Chinese Documentation

xml.Revit.MCP offers a comprehensive set of tools for integrating with Autodesk Revit via the Model Context Protocol (MCP). This library serves as a bridge between AI assistants and Revit, enabling powerful automation capabilities and programmable interactions with building models.

🚀 Quick Start

xml.Revit.MCP provides a seamless way to integrate with Autodesk Revit, enabling automation and interaction with building models.

✨ Features

This tool library includes numerous functions for Revit automation and interactive operations:

Basic Operations

• Get available commands for Revit plugins.
• Execute specified Revit commands.
• Invoke specific Revit functions with parameters.
• Retrieve view data and selected elements.

Element Management

• Find elements by category.
• Get element parameters and positions.
• Update element parameters.
• Delete elements.
• Display/highlight elements in the current view.
• Move elements to new positions.

Creation Tools

• Create floors/slabs.
• Create floor plan views.
• Create grid lines.
• Create walls and floors.
• Create rooms and room tags.
• Create doors and windows.
• Create MEP elements (ducts, pipes, cable trays).
• Create family instances.
• Link DWG files.
• Create sheets.

📦 Installation

Requirements

• xml.Revit: Version 1.3.4.3 or higher.
• Python: 3.10 or higher.
• UV Package Manager: Install the required tools.
• Revit: Compatible with versions 2019 - 2024 (requires plugins).

Installation Steps

1. First, install the UV package manager:

   pip install uv
   

2. Install the revit - mcp package:

   pip install revit-mcp
   

3. Test the installation:

   uvx revit-mcp
   

   You should see: RevitMCPServer - INFO - Successfully connected to Revit on startup

📚 Documentation

Integration with AI Assistants

Claude for Desktop

Edit the claude_desktop_config.json file and add:

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Cursor

Edit the mcp.json file and add:

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Cline

Edit the cline_mcp_setting.json file and add:

{
    "mcpServers": {
        "RevitMCPServer": {
            "command": "uvx",
            "args": [
                "revit-mcp"
            ]
        }
    }
}

Extended Functionality

You can implement more features by creating custom MCP DLL files:

1. Implement the xml.Revit.MCP.Public.IMCPMethod interface.
2. Communicate following the JSON - RPC 2.0 specification.
3. Compile it into a DLL and place it in the specified MCP folder.

Plugin Configuration

When using the revit-mcp-plugin:

1. Register the plugin in Revit.
2. Configure commands via: Add - ins → Revit MCP Plugin → Settings.
3. Enable the service: Add - ins → Revit MCP Plugin → Revit MCP Switch.

After enabling, the AI assistant can discover and control your Revit program and perform corresponding operations.