← 返回目录

Sketchup MCP

社区

通过MCP将Sketchup与Claude AI连接，实现提示驱动的3D建模与场景操控。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 391 / 438
Stars: ★ 487 热门
传输方式: stdio（本地进程）
运行环境: Python · 预编译二进制
凭据: 无需凭据
最近提交: 5 个月前
工具数: 8

35FMRS · D

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

最强项 · 安装易用性 11/20 最弱项 · 安全与权限 3/20

可靠性

5/20

安全与权限

3/20

维护活跃度

6/20

文档质量

10/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 仅依据 README 进行静态审查，仓库源码和 Server Manifest 均未提供，无法验证 MCP 初始化握手、工具列表与实际行为是否一致；没有测试、CI 或运行日志作为可执行证据。虽有合理的架构描述和工具列表，但错误处理、超时和边界行为均无证据，故保守给 5 分。
安全与权限 3/20: README 明确提供 eval_ruby 工具，可直接在 SketchUp 中执行任意 Ruby 代码，且 TCP 服务默认监听 9876 端口，未提及认证、授权或危险操作的二次确认机制；这属于无确认的远程命令执行，触及红线的 0-4 分区间。没有发现恶意代码或凭据窃取证据，因此给 3 分。
维护活跃度 6/20: README 声明 MIT 许可证，仓库未归档，且提到 PyPI 发布与欢迎贡献，但未提供提交历史、版本发布记录、依赖更新策略、问题响应时间或安全响应渠道；17 个开放 issue 的具体状态和时效未知。星标数仅作发现信号不计分，故给 6 分。
文档质量 10/20: README 覆盖功能特性、安装步骤、Claude 客户端配置、工具列表、示例命令、故障排查、通信协议和许可证，整体可用。但缺少各工具的详细参数说明、权限/安全边界、限制条件、Python 版本要求和部署环境细节，属于可用但有隐藏假设的状态，故给 10 分。
安装易用性 11/20: 安装路径包括 uv、Sketchup 扩展 .rbz 安装、扩展菜单启动服务以及 Claude JSON 配置示例，步骤较清晰，主流客户端配置有示例。但 .rbz 的下载/构建过程、本地开发服务工作方式、Python 版本和平台兼容性均未说明，且没有 CI 或测试证据验证可重复安装，静态校准上限为 15，故给 11 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件执行命令或代码

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Python · 预编译二进制

使用 brew install uv 安装uv。
下载或构建最新的.rbz文件，在Sketchup中通过Window > Extension Manager安装扩展，并重启Sketchup。
使用uvx运行MCP服务器（uvx sketchup-mcp），并配置Claude使用该MCP服务器。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "sketchup": {
      "command": "uvx",
      "args": [
        "sketchup-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add sketchup -- uvx sketchup-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Sketchup 中通过 Extensions > SketchupMCP > Start Server 启动扩展服务（默认端口 9876）后，在 Claude 的工具列表中应出现 get_scene_info 等工具；调用 get_scene_info 能返回当前场景信息即证明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建一个带屋顶和窗户的简单房子模型
获取当前选中组件的信息
把选中的组件改成红色
把选中的组件向上移动 10 个单位

工具能力 8

get_scene_info 只读

获取当前Sketchup场景的信息。

get_selected_components 只读

获取当前选中组件的信息。

create_component 写入

使用指定参数创建新组件。

delete_component 破坏性

从场景中移除组件。

transform_component 写入

移动、旋转或缩放组件。

set_material 写入

为组件应用材质。

export_scene 写入

将当前场景导出为多种格式。

eval_ruby 写入

在SketchUp中执行任意Ruby代码以进行高级操作。

使用场景

通过自然语言指示创建3D模型，例如创建房屋模型。

查询和修改当前场景中的组件。

应用材质或更改组件属性。

将场景导出为3D模型。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

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