Revit MCP 서버

🏗️ Revit MCP 서버

Claude AI와 Autodesk Revit 간의 원활한 통신을 가능하게 하는 Revit 통합을 위한 모델 컨텍스트 프로토콜 서버입니다.

🎯 개요

이 TypeScript 기반 MCP 서버는 Claude AI와 Revit을 연결하는 브리지 역할을 하며, WebSocket 연결을 통해 Revit 모델과 직접 상호 작용할 수 있도록 합니다. Model Context Protocol을 구현하여 다음을 지원합니다.

⚡ Revit 모델 정보에 실시간으로 액세스
🔍 요소 쿼리 및 필터링
👀 뷰 및 레벨 관리
🛡️ 대체 모의 데이터를 통한 강력한 오류 처리

✨ 특징

🔌 Revit 통합

📡 Revit 플러그인을 사용한 WebSocket 기반 통신
🔄 실시간 모델 데이터 접근
🔁 연결 실패 시 모의 데이터로의 우아한 폴백
⚙️ 환경 변수를 통해 구성 가능한 연결 설정

🚀 핵심 기능

📊 모델 정보
- 기본 모델 메타데이터(이름, 경로, 버전)에 액세스합니다.
- 요소 수와 마지막 수정 날짜를 가져옵니다.
- 실시간 모델 상태 동기화
🏗️ 요소 관리
- 유연한 필터링이 가능한 쿼리 요소
- 요소 속성 및 기하학에 액세스
- 배치 요소 작업
🎪 뷰 및 레벨 제어
- 사용 가능한 모든 뷰 나열
- 접근 수준 정보
- 모델 계층 구조 탐색

💻 개발

📋 필수 조건

Node.js(v14 이상)
엔피엠
Autodesk Revit(2023 이상)
Revit WebSocket 플러그인(보조 플러그인)

🔧 설치

종속성 설치:

지엑스피1

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

⚙️ 구성

서버는 환경 변수를 사용하여 구성할 수 있습니다.

REVIT_HOST=127.0.0.1    # Revit plugin WebSocket host
REVIT_PORT=8080         # Revit plugin WebSocket port

🔗 Claude Desktop과 통합

Claude Desktop에 서버 구성을 추가합니다.

윈도우:

%APPDATA%/Claude/claude_desktop_config.json

구성 형식:

{
  "mcpServers": {
    "revit-mcp-server": {
      "command": "D:/path/to/revit-mcp-server/build/index.js"
    }
  }
}

🐛 디버깅

MCP 통신 디버깅을 위해:

내장된 MCP 검사기를 사용하세요:

npm run inspector

Revit 플러그인을 사용하여 WebSocket 통신 모니터링
연결 및 작업 상태를 확인하려면 서버 로그를 확인하세요.

⚠️ 오류 처리

서버는 강력한 오류 처리를 구현합니다.

Revit 연결이 실패하면 모의 데이터로 자동 폴백
자세한 오류 로깅
우아한 연결 복구

📄 라이센스

MIT 라이센스

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트도 자유롭게 제출해 주세요.

📬 문의하기

질문이나 제안 사항이 있으시면 언제든지 문의해 주세요.

📧 이메일: 353554036@qq.com
💬 위챗 계정: modian4500

Revit MCP Server

Integrations