Skip to main content
Glama
yufeioptimal

cloudcompare-mcp

by yufeioptimal

cloudcompare-mcp

用于 CloudCompare 的跨平台 模型上下文协议 (MCP) 服务器 —— 让 AI 助手(如 Claude 等)能够通过自然语言处理 3D 点云和网格。

功能

工具

描述

get_cloudcompare_info

检查安装及版本

load_cloud_info

查看文件统计信息(点数、边界框、标量场)

subsample

降低密度 —— 随机 / 空间 / 八叉树

compute_cloud_to_cloud_distances

C2C 最近邻距离

compute_cloud_to_mesh_distances

C2M 有向距离

icp_registration

使用 ICP 对齐两个点云

compute_normals

估计表面法线

filter_by_scalar_field

按标量值对点进行阈值过滤

statistical_outlier_removal

使用 SOR 滤波器去除噪声

merge_clouds

合并多个点云

convert_format

在 LAS/LAZ, PLY, PCD, XYZ, E57, OBJ 等格式间转换

run_cloudcompare_command

执行任意 CLI 命令的逃生舱

要求

  • 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. 平台默认位置:

平台

默认路径

macOS

/Applications/CloudCompare.app/Contents/MacOS/CloudCompare

Windows

C:\Program Files\CloudCompare\cloudcompare.exe

Linux

/usr/bin/cloudcompare

设置 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 文件,将其空间下采样至 5 厘米,然后去除统计离群点。"

Claude 将按顺序调用相应的工具并报告结果。

支持的文件格式

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

许可证

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yufeioptimal/cloudcompare-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server