← 返回目录
S

Sketchup MCP

社区
通过MCP将Sketchup与Claude AI连接,实现提示驱动的3D建模与场景操控。
GitHub 源仓库 ↗
★ 388 Stars 分类 · 开发工具 热门 源版本 aa096f04d3d7
35FMRS · D
可靠性
5/20
安全与权限
3/20
维护活跃度
6/20
文档质量
10/20
安装易用性
11/20

该MCP服务器为Sketchup提供了强大的AI集成能力,但需要用户具备一定的技术背景,并注意安全风险。

查看 FMRS 评分方法 →

SketchupMCP通过Model Context Protocol (MCP)将Sketchup与Claude AI连接,使Claude能够直接与Sketchup交互并控制它。该集成支持基于提示的3D建模、场景创建和操作。系统由两个组件组成:一个在Sketchup内创建TCP服务器的扩展,以及一个实现MCP并连接该扩展的Python服务器。它提供双向通信、组件操作、材质控制、场景检查、选择处理和Ruby代码执行等功能。

工具能力

get_scene_info
获取当前Sketchup场景的信息。
get_selected_components
获取当前选中组件的信息。
create_component
使用指定参数创建新组件。
delete_component
从场景中移除组件。
transform_component
移动、旋转或缩放组件。
set_material
为组件应用材质。
export_scene
将当前场景导出为多种格式。
eval_ruby
在SketchUp中执行任意Ruby代码以进行高级操作。

安装接入

  1. 使用 brew install uv 安装uv。2. 下载或构建最新的.rbz文件,在Sketchup中通过Window > Extension Manager安装扩展,并重启Sketchup。3. 使用uvx运行MCP服务器(uvx sketchup-mcp),并配置Claude使用该MCP服务器。
claude_desktop_config.json
{
  "mcpServers": {
    "sketchup": {
      "command": "uvx",
      "args": [
        "sketchup-mcp"
      ]
    }
  }
}

选型与风险

适合谁

  • 使用Sketchup进行3D建模并希望集成AI辅助的用户。
  • 需要自动化建模或场景操作的设计师和开发者。
  • 熟悉Ruby并希望扩展Sketchup功能的用户。

不适合谁

  • 不使用Sketchup的用户。
  • 需要实时渲染或复杂动画的轻量级场景。
  • 对服务器安全性要求极高且不允许执行任意代码的环境。

所需权限

  • 在Sketchup内创建、修改、删除组件。
  • 执行任意Ruby代码,可能影响Sketchup环境。
  • 通过TCP端口(默认9876)进行网络通信。

风险与副作用

  • eval_ruby工具允许执行任意Ruby代码,可能导致Sketchup崩溃或数据损坏。
  • TCP连接未加密,可能被截获。
  • 依赖Sketchup和MCP服务器同时运行,否则连接失败。

常见排障

  1. 确保Sketchup扩展服务器和MCP服务器都已启动。
  2. 检查Sketchup的Ruby控制台以查看错误消息。
  3. 对于超时错误,尝试简化请求或分解为更小的步骤。

使用场景

通过自然语言指示创建3D模型,例如创建房屋模型。
查询和修改当前场景中的组件。
应用材质或更改组件属性。
将场景导出为3D模型。

支持客户端

Claude Desktop完整支持