Revit MCP自动化服务器

Revit MCP Enhanced

An advanced Model Context Protocol (MCP) server for comprehensive Revit automation and drafting through natural language. Enhanced with 155+ powerful tools for complete BIM automation: Architectural (structural systems, multi-story buildings, walls, floors, roofs, stairs, ramps, curtain walls), MEP (electrical circuits & panels, HVAC ducts & equipment, plumbing pipes & fixtures, fire sprinkler systems, load calculations, auto-routing), Energy & Sustainability (energy analysis, solar exposure, daylighting, carbon footprint), Parametric Design (create/edit families, adaptive components), Design Options (variant exploration, cost/performance comparison), Cost Estimation (quantity takeoffs, RSMeans integration), Structural Analysis (analytical models, load applications), Advanced Site Design (property lines, parking layouts, landscaping), Coordination (clash detection, measurements, element relationships, phasing), Geometry Operations (copy, array, mirror, trim, split, offset), Visualization (3D views, assemblies), Import/Export (CAD, model linking, PDF/DWG export), Materials & Parameters (browse/assign materials, read/write parameters), AI-Driven (layout optimization, auto-furnishing, code compliance), Worksets (multi-user collaboration), Model Optimization (purge, audit, compress), and Fabrication (shop-ready MEP detailing with spool sheets).

Description

revit-mcp allows you to interact with Revit using the MCP protocol through MCP-supported clients (such as Claude Desktop, Cline, and other AI assistants).

This project is the MCP server side (providing Tools to AI). You need to use revit-mcp-plugin (the Revit plugin that drives Revit API) in conjunction.

Key Features

• AI Design Analysis & Validation: Deep model scanning that returns structured issue reports with exact coordinates, eliminating LLM hallucination and enabling precise correction code generation
• BIM Interoperability: IFC import/export (IFC2x3, IFC4, IFC4x3) for open BIM workflows, cross-platform coordination (Navisworks, Solibri, Tekla, ArchiCAD), and owner handover (COBie)
• Production Documentation: Export schedules (CSV, Excel, JSON) for specifications/estimating/FM, view templates for standardizing 100s of views, batch template application
• Energy & Sustainability: Energy simulation (ASHRAE 90.1, IECC), solar exposure analysis, daylighting metrics (sDA/ASE for LEED v4), and carbon footprint (embodied + operational)
• Parametric Design: Create and edit families programmatically, adaptive components for complex facades, AI-generated custom components
• Design Options & Variants: Explore multiple design alternatives in one model, compare by cost/energy/carbon, AI recommends optimal solution
• Cost Estimation: Automated quantity takeoffs by material/CSI division, construction cost estimates with RSMeans integration, value engineering
• Structural Analysis: Analytical model generation, load applications (dead, live, wind, seismic), export to FEA software (Robot, SAP2000, ETABS)
• Advanced Site Design: Property lines with setback validation, auto-generated parking layouts (ADA-compliant), landscaping with trees/furniture
• Intelligent Furniture Automation: Room-aware furniture placement, auto-furnishing by room type, furniture catalog browsing, and AI-driven layout optimization
• Advanced Drafting Tools: Auto-dimensioning (9 modes), drafting views, legend creation, annotation symbols with auto-numbering, spot elevations
• Building Code Compliance: Automated checks for egress, ADA/accessibility, fire safety, and spatial requirements (IBC, NBC India, Eurocode)
• Layout Optimization: AI-driven room layout optimization with 8 strategies (space efficiency, circulation, ergonomics, natural light, etc.)
• Auto-Alignment: Detect and correct misaligned walls, columns, doors, and furniture with configurable tolerance
• Mirror & Copy Layouts: Replicate furniture layouts between rooms, copy floor plans across levels
• Worksets & Collaboration: Multi-user worksharing with workset management, element assignment by discipline/zone/phase
• Model Optimization: Purge unused elements, audit/repair database, compress file size, fix warnings, identify heavy families
• Comprehensive Data Retrieval: Get detailed spatial/geometric data from Revit projects with intelligent filtering
• Structural Systems: Beams, trusses, braces, foundations (wall/isolated/strip/mat) — complete structural framework for multi-story buildings
• Multi-Story Building: Create levels with auto-spaced floors, copy elements between levels, array structural bays
• Wall Creation: Dedicated wall tool with stacked walls, embedded walls, location line control, and layer structure configuration
• Drafting Automation: Dedicated tools for floors (sloped, structural), ceilings (grid pattern, bulkhead), roofs (footprint, extrusion), curtain walls, curtain grids, mullions, stairs, ramps, railings, columns, and openings
• Coordination & Analysis: Element relationship analysis, distance measurement, clash detection (geometric collision detection between disciplines)
• Phasing & Renovation: Create phases (Existing, Demolition, New Construction), assign phase created/demolished to elements
• Geometry Operations: Copy, array (linear/radial/2D grid), mirror, split, trim/extend, offset, join/unjoin geometry, and group elements — the core drafting efficiency tools
• Wall Detailing: Edit wall profiles (parapets, stepped), wall sweeps (cornices, baseboards, crown molding), and wall reveals (groove lines)
• Site Design: Create topography surfaces, building pads, and site grading
• Family & Component Management: Load families from library, browse loaded families catalog by category, and place component instances with host element support
• Parameters & Materials: Read/write any element parameter, browse project materials, assign materials by parameter or paint
• Area Planning: Create area plans, area boundaries, and calculate rentable/gross areas per BOMA standards
• 3D Views & Visualization: Create perspective and orthographic 3D views with camera control, preset orientations, section boxes, and display styles
• Import & Linking: Import CAD (DWG/DXF) for reference, link Revit models for coordination, manage linked model positioning
• Assembly Views: Create construction detail assemblies with auto-generated views for shop drawings and prefab coordination
• Export & Documentation: Export views to PNG, JPEG, PDF, DWG, DXF with configurable resolution, paper size, and layer mapping
• Electrical Systems: Circuits, panels, fixtures, conduit routing, NEC load calculations — complete power & lighting design
• Mechanical (HVAC) Systems: Ductwork, AHUs, VAVs, diffusers, system definition, ASHRAE load calculations — complete HVAC design
• Plumbing Systems: Pipes, fixtures, water/sanitary/storm systems, fixture unit calculations — complete plumbing design
• Fire Protection: Sprinkler systems with NFPA 13 compliance, auto head spacing, hazard classification
• MEP Coordination: Auto-routing with clash avoidance, MEP spaces, fabrication-ready detailing with spool sheets
• Advanced Element Creation: Create walls, floors, ceilings, roofs, rooms, columns, and families with natural language
• Complete Element Modification: Move, rotate, resize, change type, flip, mirror, pin/unpin, and set parameters
• View & Sheet Management: Automate view creation, duplication, and sheet organization
• Annotation Automation: Batch tag elements, create dimensions, add text notes, and detail lines
• Room & Space Planning: Create and manage rooms with automatic area calculations
• Grid & Reference Systems: Create grids, reference planes, model lines, and level management
• Visual Controls: Color-code elements, set transparency, isolate, hide, and highlight
• Spatial Validation: Check clearances, overlaps, adjacencies, and accessibility compliance
• AI-Generated Code Execution: Send custom code to Revit for complex operations

Requirements

• nodejs 18+

Complete installation environment still needs to consider the needs of revit-mcp-plugin, please refer to revit-mcp-plugin

⚡ Quick Setup (5 minutes)

Automated Setup (Recommended)

Windows:

./quick-setup-secure.bat

Linux/Mac:

chmod +x quick-setup-secure.sh
./quick-setup-secure.sh

This auto-generates your API key, creates certificates, and configures everything!

What Gets Generated

After running setup, you'll have:

• ✅ Random 64-char API Key - Saved in .env file automatically
• ✅ SSL Certificates - For secure HTTPS connection
• ✅ Configuration - .env file with all settings

Configure Claude Desktop

Edit your Claude config (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "revit-mcp": {
      "url": "https://localhost:3000",
      "env": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Get your API key from the .env file created by setup script.

Start Server

# Option 1: Direct
node server-secure.js

# Option 2: PM2 (Recommended)
npm install -g pm2
pm2 start ecosystem-secure.config.js
pm2 logs revit-mcp-secure

Verify Connection

# Test health (no auth needed)
curl -k https://localhost:3000/health

# Test with API key
curl -k https://localhost:3000/status -H "X-API-Key: YOUR_KEY_FROM_.env"

🔐 Security Features

✅ API Key Authentication - All requests require valid API key
✅ HTTPS/TLS - Encrypted communication
✅ IP Whitelist - Optional, restrict by network
✅ Rate Limiting - 100 requests/minute (configurable)
✅ Default Localhost - Zero public exposure by default

See START_HERE.md for more options.

Framework

flowchart LR
	CladueDesktop --> revit-mcp --> SocketService--commandName-->CommandlSet--command-->CommandExecute
	CommandManager --> CommandlSet
	CommandExecute --executeResult--> SocketService
	CommandProject1 --> CommandManager
	CommandProject2 --> CommandManager
	CommandProject... --> CommandManager
	subgraph ide1 [MCPClient]
	CladueDesktop
	end
	subgraph ide2 [MCPServer]
	revit-mcp
	end
	subgraph ide3 [Revit]
			subgraph ide3.1 [revit-mcp-plugin]
				SocketService
				CommandlSet
				CommandManager
				CommandExecute
			end
	end

Supported Tools (155+)

🧠 AI Design Analysis & Validation (NEW)

These tools eliminate LLM hallucination by providing ground-truth model data. Always run analyze_layout_design before making design decisions.

🪑 Furniture & Layout Automation (NEW)

📐 Annotation & Drafting Tools (EXPANDED)

📊 Data Retrieval & Querying

🏗️ Element Creation (Generic)

🧱 Wall Creation (NEW)

🏢 Drafting Automation — Floors, Ceilings & Roofs (NEW)

Dedicated tools with full parameter support for each element type. These go far beyond generic surface-based creation by exposing slope, structural properties, grid patterns, overhangs, and more.

🔲 Curtain Wall System (NEW)

Complete curtain wall workflow: create the wall, configure the grid, then place mullions. Each tool provides granular control over the curtain wall components.

🪜 Stairs, Ramps & Railings (NEW)

Full vertical circulation tools with building code awareness. Stairs auto-calculate riser count from floor-to-floor height. Ramps support ADA slope compliance. Railings can be standalone or hosted on stairs/ramps.

🏛️ Columns (NEW)

🔩 Structural Systems (NEW)

Complete structural framework for multi-story buildings. Beams span between columns, trusses support roofs, braces resist lateral loads, and foundations transfer loads to ground.

📐 Multi-Story & Level Management (NEW)

🧱 Wall Detailing (NEW)

Interior and exterior wall finish detailing. Essential for production-grade architectural drawings.

🌍 Site & Topography (NEW)

🔄 Geometry Operations (NEW)

The core drafting efficiency tools. Copy, array, mirror, split, trim, offset, and group — these operations are essential for efficiently building complete designs from repeated patterns.

🎛️ Parameters & Materials (NEW)

Read and write any element property. Essential for LLM to understand and control element characteristics, assign finishes, and produce accurate schedules.

🔍 Analysis & Coordination (NEW)

Essential for AI to understand model relationships, verify clearances, detect conflicts, and ensure constructability.

🏗️ Phasing & Renovation (NEW)

For renovation projects and phased construction. Show existing conditions, demolition, and new construction.

📐 Model Geometry (NEW)

📏 Area Planning (NEW)

📤 Export & Documentation (NEW)

📥 Import & Linking (NEW)

Bring in external references for coordination and context.

📦 Family & Component Management (NEW)

These tools enable LLM-assisted component selection: first discover what's available (loaded or in library), then place the right component. Essential for AI-driven drafting workflows.

⚡ MEP (Mechanical, Electrical, Plumbing) Systems (NEW)

🔌 Electrical Systems (NEW)

Complete electrical design: circuits, panels, fixtures, conduit routing, and NEC-compliant load calculations.

❄️ Mechanical (HVAC) Systems (NEW)

Complete HVAC design: ductwork, equipment placement, system definition, and ASHRAE load calculations.

💧 Plumbing Systems (NEW)

Complete plumbing design: pipes, fixtures, systems, and fixture unit calculations.

🚨 Fire Protection (NEW)

Fire sprinkler system design with NFPA 13 compliance.

🔧 MEP Coordination (NEW)

MEP spaces, auto-routing, and fabrication-ready detailing.

🌐 BIM Interoperability & Production Documentation (NEW)

📦 IFC Import/Export (NEW)

Open BIM workflows with IFC (Industry Foundation Classes) — the universal exchange format for cross-platform coordination, owner handover (COBie), and multi-discipline collaboration.

📊 Schedule Data Export (NEW)

Export schedule data to external systems for specifications, estimating, facility management, and AI-driven document generation.

🎨 View Templates (NEW)

Standardize documentation with view templates — instantly propagate graphic settings to 100s of views, enforce corporate standards, and update views when standards change.

⚡ Advanced Design Automation & Intelligence (NEW)

🌱 Energy Analysis & Sustainability (NEW)

Performance-driven design with energy simulation, solar analysis, daylighting, and carbon footprint calculations. Essential for sustainable design, green building certifications (LEED, WELL), and energy code compliance.

🔀 Design Options & Variants (NEW)

Explore design alternatives within a single model. AI can generate multiple options (facade systems, structural schemes, layouts) and compare them quantitatively to recommend the optimal solution.

🏗️ Parametric Family Creation (NEW)

Create custom Revit families programmatically. AI can generate bespoke components instead of being limited to existing libraries. Essential for custom furniture, specialized equipment, and unique architectural elements.

💰 Quantity Takeoffs & Cost Estimation (NEW)

Cost-aware design with automated material quantities and construction cost estimates. Essential for budget validation, value engineering, and cost-driven design optimization.

🏗️ Structural Analysis Integration (NEW)

Bridge design and engineering with analytical models and load applications. Essential for structural validation and coordination with analysis software (Robot, SAP2000, ETABS, STAAD).

🌳 Advanced Site Design (NEW)

Complete site planning with property lines, parking layouts, and landscaping. Essential for zoning compliance, site layout optimization, and exterior visualization.

👥 Worksets & Collaboration (NEW)

Multi-user collaboration for large projects. Organize model elements by discipline, zone, or phase to enable concurrent work by team members and AI-driven element organization.

⚙️ Model Optimization & Maintenance (NEW)

Keep models healthy and performant. Essential after AI-driven bulk element creation to prevent model bloat and maintain responsiveness.

📍 Advanced Annotations (NEW)

Construction documentation with spot elevations and spot coordinates.

👁️ View Management

📄 Sheet & Viewport Management

📏 Grid & Reference Systems

🏠 Room & Space Management

📊 Schedules & Analysis

🎨 Detail Components

📝 Revision & Documentation

✏️ Element Modification & Operations (EXPANDED)

🔧 Advanced Tools

💾 Data Persistence

AI Design Analysis Workflow

The analyze_layout_design tool is the cornerstone of accurate AI-driven design review. Here's how it eliminates hallucination and enables precise corrections:

flowchart TD
    A[User asks AI to review/modify design] --> B[analyze_layout_design]
    B --> C{Structured Report}
    C --> D[elements: All elements with exact coordinates]
    C --> E[issues: Overlaps, misalignment, missing elements, code violations]
    C --> F[statistics: Summary counts and metrics]
    C --> G[spatial_map: Room-element relationships]
    E --> H[Each issue has: severity, elementIds, coordinates, suggestedFix]
    H --> I[LLM generates targeted correction code]
    I --> J{Apply via}
    J --> K[modify_element - move/rotate/resize]
    J --> L[send_code_to_revit - complex C# operations]
    J --> M[auto_align_elements - fix misalignment]
    J --> N[place_furniture_in_room - fix furniture]
    K & L & M & N --> O[validate_spatial_relationships]
    O --> P{All clear?}
    P -->|Yes| Q[Design validated]
    P -->|No| B

Why This Prevents Hallucination

Recommended Workflow for AI Assistants

Architectural Phase:

1. Set up levels: Use create_level with autoSpaceFloors to establish multi-story structure
2. Analyze existing model: Call analyze_layout_design with analysisScope: "full" before making changes
3. Understand relationships: Use get_element_relationships to understand host/hosted dependencies before modifications
4. Get spatial data: Use get_element_spatial_data for precise coordinates; get_element_parameters for properties
5. Discover components: Use get_loaded_families or load_family to find available family types
6. Build structure: Use create_column, create_beam, create_foundation for structural system
7. Create enclosure: Use create_wall, create_floor, create_roof, create_curtain_wall, and openings
8. Detail interiors: Use create_ceiling, create_stairs, create_railing, create_wall_sweep for finishes
9. Replicate across levels: Use copy_elements BetweenLevels, array_elements, mirror_elements for efficiency
10. Assign materials & phases: Use get_project_materials + set_element_material for finishes; manage_phases + set_element_phase for renovation

MEP Phase: 11. Define MEP spaces: Use create_mep_space for mechanical rooms, electrical rooms, shafts 12. Calculate loads: Use calculate_hvac_load for HVAC sizing, calculate_electrical_load for panel sizing 13. Place equipment: Use place_mechanical_equipment (AHUs, VAVs), place_electrical_equipment (panels), place_plumbing_fixture (sinks, toilets) 14. Route distribution: Use create_duct, create_pipe, route_conduit, or route_mep_path for auto-routing 15. Create systems: Use create_mechanical_system, create_plumbing_system, create_electrical_circuit to organize equipment 16. Add fire protection: Use create_sprinkler_system with NFPA auto-layout

Coordination & Documentation: 17. Coordinate & validate: Run detect_clashes (especially discipline vs discipline), measure_distance, validate_spatial_relationships, and check_building_code_compliance 18. Fabrication detailing: Use create_mep_fabrication for shop-ready MEP with spool sheets 19. Create views: Use create_3d_view for presentation, create_assembly for construction details 20. Document & export: Use export_view to generate deliverables (PDF, DWG, images)

Complete Multi-Story Building Workflow (NEW)

flowchart TD
    A[Start: Multi-Story Building] --> B[create_level — autoSpaceFloors]
    B --> C[create_grid — Structural grid layout]
    C --> D[create_column — At grid intersections]
    D --> E[create_beam — Between columns]
    E --> F[create_foundation — Under columns/walls]
    F --> G{Create per-level elements}
    G --> G1[create_floor — Each level slab]
    G --> G2[create_line_based_element — Walls]
    G --> G3[create_curtain_wall — Facade]
    G3 --> G3a[create_curtain_grid] --> G3b[create_mullion]
    G --> G4[create_stairs + create_railing]
    G --> G5[create_ramp + create_railing]
    G1 & G2 & G3b & G4 & G5 --> H[copy_elements BetweenLevels — Repeat to all floors]
    H --> I{Interior Detailing}
    I --> I1[create_ceiling — Grid/bulkhead]
    I --> I2[create_room + auto_furnish_room]
    I --> I3[create_wall_sweep — Baseboards, cornices]
    I --> I4[create_opening — Doors, windows, shafts]
    I1 & I2 & I3 & I4 --> J[create_roof + create_truss]
    J --> K[set_element_material — Apply finishes]
    K --> L[validate_spatial_relationships]
    L --> M[check_building_code_compliance]
    M --> N[export_view — PDF/DWG deliverables]