🏗️ Revit MCP 서버

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

영어 | 중국어

🎯 개요

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

• ⚡ Revit 모델 정보에 실시간으로 액세스

• 🔍 요소 쿼리 및 필터링

• 👀 뷰 및 레벨 관리

• 🛡️ 대체 모의 데이터를 통한 강력한 오류 처리

Related MCP server: QGISMCP

✨ 특징

🔌 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 통신 디버깅을 위해:

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

npm run inspector

2. Revit 플러그인을 사용하여 WebSocket 통신 모니터링

3. 연결 및 작업 상태를 확인하려면 서버 로그를 확인하세요.

⚠️ 오류 처리

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

• Revit 연결이 실패하면 모의 데이터로 자동 폴백

• 자세한 오류 로깅

• 우아한 연결 복구

📄 라이센스

MIT 라이센스

🤝 기여하기

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

📬 문의하기

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

• 📧 이메일: 353554036@qq.com

• 💬 위챗 계정: modian4500