1. 首页
  2. SketchUp MCP
  3. 安装

SketchUp MCP 怎么装

装 SketchUp MCP 就是让两个东西对上话:SketchUp 里的 Ruby 插件,和你 AI 客户端能连上的 MCP 服务。开源那条不花钱,顺利的话二十分钟。

更新于 2026-09-13 · 梓人AI

先搞清你在连什么

Ruby 插件在 SketchUp 里加载,开一个本地端口。Python 进程是 MCP 服务,由 AI 客户端启动,把调用转发到那个端口。

所以能出错的就三处:插件没加载、服务没跑、客户端起不了服务。几乎所有问题都是这三个之一。

路线一:开源方案

第一步 装 uv

社区的服务是 Python 包,靠 uvx 跑。macOS:

brew install uv

Windows 用 uv 官方安装程序。装完确认在 PATH 里:

uvx --version

提示找不到命令就先解决。后面很多报错其实都是这一条换了个样子冒出来。见 spawn uvx ENOENT。

第二步 装 SketchUp 插件

下载项目的 .rbz。SketchUp 里打开窗口 → 扩展程序管理器,点安装扩展程序,选那个文件。然后重启 SketchUp。

有的项目还在插件菜单下放了设置面板,要先打开 Ruby 执行权限才会接受命令。插件装上了毫无反应,先看这里。

第三步 把服务注册给 AI 客户端

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

必须是合法 JSON。多一个逗号,或者从网页复制带了中文引号,客户端会一声不吭地失败,列表里什么都不显示。这是最常见的错。

第四步 重启客户端,先验后用

完全退出再打开 AI 客户端。大多数客户端运行中不重读配置。SketchUp 的工具应该出现在工具列表里。

先问点小的:「这个模型里有几个群组」。答得上来再去干创建几何体的活。

端口

插件和服务通过本地端口通信。哪个端口看项目:9876 和 8080 都有人用。被别的东西占着的话,插件正常加载、服务正常启动,然后什么都不工作。见端口那节。

路线二:软件自己配

梓人AI 把路线一整套替你做了,按软件逐个做。没有包管理器要装、没有 JSON 要改、没有 AI 客户端要注册,因为客户端就是这个软件。

  1. 装 梓人AI。它列出在你电脑上找到的建模软件。
  2. SketchUp 那行点「配置」。插件和运行环境装好并连上。一个软件一次。
  3. 描述任务。每次执行前重连,出问题点名是哪一环,并给修法。

下载 Windows 版

走哪条

不怕命令行、而且已经在付某个 AI 客户端的钱,走开源那条不额外花钱,核心的活它也干得了。注意那句「已经在付」:服务端免费,建模本身不免费,而这在国内往往最难凑齐。

软件这条值得花钱,如果:你不想拿一个晚上去调 PATH;不想再凑一个境外 AI 订阅;或者想每次都有人替你把连接检查一遍,而不是干到一半发现插件在某次更新后悄悄不加载了。

环境要求

连不上的话

见过的失败大致八九种,每种都有一句能认出来的报错。都在同一页。

排错 →