Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@cloudcompare-mcp inspect cave_scan.laz and show its point count, extent, and 3D spacing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Model Context Protocol (MCP) server for CloudCompare — lets Claude (Desktop or Code) inspect and process point clouds and meshes in natural language.
Fork of yufeioptimal/cloudcompare-mcp (MIT), fixed and tuned for enclosed 3D surveys such as caves, tunnels and hypogea.
Bugs fixed (CloudCompare command line) — checked against CloudCompare's own ccCommandLineCommands.cpp:
Tool | Upstream problem | Fix |
all |
| pinned |
all | CloudCompare auto-saves after every step by default → stray timestamped files written next to your inputs |
|
all |
| file names are quoted |
all | no global shift → precision loss with UTM / national-grid coordinates |
|
all | silent mode prints nothing → no feedback | CloudCompare log ( |
| reference and compared clouds swapped (CC: 1st = compared, 2nd = reference); save failed with 2 clouds loaded | correct order, reference dropped before saving, optional |
| model and data swapped (CC: 1st = data that moves, 2nd = fixed model); save failed with 2 clouds loaded | correct order, model dropped before saving, |
| used |
|
| always filtered the active field (often none) |
|
| called a non-existent | reads the log |
|
| unsupported extensions are rejected with a clear message |
Native tools (no CloudCompare needed):
3D density. Upstream reported points / XY bounding-box area — meaningless for a cave, a shaft or any enclosed space. Now: median / mean / p95 nearest-neighbour spacing and surface density (pts/m² of wall, same definition as CloudCompare's), robust to subsampling.
Large files. LAS/LAZ are streamed in chunks with random sampling, so multi-GB scans don't need to fit in memory. Point count and bounding box come from the header (exact).
Real intensity colouring (upstream used Z as a "proxy").
Plan + two elevations at true scale (equal aspect), CRS shown when the LAS has one.
Blocking work runs off the MCP event loop; long CloudCompare jobs time out after 2 h (CLOUDCOMPARE_TIMEOUT in seconds).
Related MCP server: cloudcompare-mcp
Tool | CloudCompare needed | Description |
| – | Point count, bbox, extent, 3D spacing & surface density, attributes |
| – | PNG with plan, two elevations and metadata panel, coloured by height / RGB / intensity |
| ✓ | Check installation |
| ✓ | Open any CC-readable file (E57, BIN, PTX…) and return the log |
| ✓ | Random / spatial (min spacing) / octree |
| ✓ | C2C, e.g. survey vs re-survey |
| ✓ | C2M signed distances |
| ✓ | Align a cloud onto a fixed reference |
| ✓ | Octree normals (LS / quadric / triangulation) |
| ✓ | Keep points within a value range of a chosen field |
| ✓ | SOR noise filter |
| ✓ | Merge several clouds |
| ✓ | LAS/LAZ, PLY, PCD, XYZ/ASC/TXT, E57, BIN, VTK, SBF |
| ✓ | Any CloudCompare command line (advanced) |
All CloudCompare tools work on files in batch (CloudCompare's command-line mode). They do not drive an open CloudCompare window.
Requirements: Python ≥ 3.10, uv (recommended), CloudCompare ≥ 2.12 for the CloudCompare tools.
Settings → Developer → Edit config, then add to claude_desktop_config.json:
{
"mcpServers": {
"cloudcompare": {
"command": "uvx",
"args": ["--from", "git+https://github.com/Stratos915/cloudcompare-mcp", "cloudcompare-mcp"]
}
}
}Restart Claude Desktop. If CloudCompare is not in a standard location, add:
"env": { "CLOUDCOMPARE_PATH": "C:\\Program Files\\CloudCompare\\CloudCompare.exe" }On macOS Claude Desktop may not see uvx on its PATH; use the full path (which uvx, e.g. /Users/you/.local/bin/uvx).
claude mcp add cloudcompare -- uvx --from git+https://github.com/Stratos915/cloudcompare-mcp cloudcompare-mcpCLOUDCOMPARE_PATH
cloudcompare / CloudCompare on PATH
Windows C:\Program Files\CloudCompare\CloudCompare.exe · macOS /Applications/CloudCompare.app/Contents/MacOS/CloudCompare · Linux /usr/bin/cloudcompare, /snap/bin/cloudcompare
"Show me D:\Rilievi\grotta.laz coloured by intensity and tell me the point spacing."
"Subsample it to 2 cm and remove noise with SOR, save as grotta_2cm.laz."
"Compare the 2026 survey with the 2024 one (reference) and keep only points that moved more than 5 cm."
Native tools are tested on synthetic tunnel clouds (spacing and surface density match the ground truth within 1 %, also from a 4 % subsample). CloudCompare command lines are generated per the CloudCompare 2.13 source and checked with a mock binary; they have not yet been run against a real CloudCompare install — please report issues.
MIT — original work © yufeioptimal; modifications © Stratos915.
This server cannot be deployed
Location tools for Claude and other MCP clients, strongest in the US and Great Britain. Geocode whole lists with a confidence score per row, filter by distance, get road distances and drive-time areas, and plan multi-driver routes with Google Maps links. Check flood zones, crime and live warnings, find nearby places and UK registers (NHS, CQC, food hygiene), and keep shareable maps. Reads and writes Google Sheets. Free: sign in with Google.
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
