cloudcompare-mcp

CloudCompare를 위한 크로스 플랫폼 Model Context Protocol (MCP) 서버 — AI 어시스턴트(Claude 등)가 자연어를 통해 3D 포인트 클라우드 및 메시를 처리할 수 있게 합니다.

기능

요구 사항

• CloudCompare ≥ 2.12 — 다운로드

• Python ≥ 3.10

• uv (권장) 또는 pip

설치

uvx를 사용한 빠른 시작 (설치 불필요)

uvx cloudcompare-mcp

로컬 설치

pip install cloudcompare-mcp
cloudcompare-mcp

CloudCompare 바이너리 감지

서버는 다음 순서로 CloudCompare를 찾습니다:

1. CLOUDCOMPARE_PATH 환경 변수

2. 시스템 PATH (cloudcompare / CloudCompare)

3. 플랫폼 기본 위치:

재정의하려면 CLOUDCOMPARE_PATH를 설정하세요:

export CLOUDCOMPARE_PATH="/opt/custom/cloudcompare"

MCP 클라이언트 구성

Claude Desktop (claude_desktop_config.json)

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

Claude Code (~/.claude/settings.json)

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

사용자 지정 바이너리 경로 사용:

{
  "mcpServers": {
    "cloudcompare": {
      "command": "uvx",
      "args": ["cloudcompare-mcp"],
      "env": {
        "CLOUDCOMPARE_PATH": "/path/to/cloudcompare"
      }
    }
  }
}

사용 예시

Claude Desktop 또는 Claude Code에서 구성이 완료되면:

"내 scan.las 파일을 로드하고 공간적으로 5cm로 서브샘플링한 다음, 통계적 이상치를 제거해 줘."

Claude가 적절한 도구를 순서대로 호출하고 결과를 보고합니다.

지원되는 파일 형식

LAS · LAZ · PLY · PCD · XYZ · ASC · TXT · E57 · OBJ · BIN · SHP

라이선스

MIT