装 SketchUp MCP 就是让两个东西对上话:SketchUp 里的 Ruby 插件,和你 AI 客户端能连上的 MCP 服务。开源那条不花钱,顺利的话二十分钟。
Ruby 插件在 SketchUp 里加载,开一个本地端口。Python 进程是 MCP 服务,由 AI 客户端启动,把调用转发到那个端口。
所以能出错的就三处:插件没加载、服务没跑、客户端起不了服务。几乎所有问题都是这三个之一。
社区的服务是 Python 包,靠 uvx 跑。macOS:
brew install uv
Windows 用 uv 官方安装程序。装完确认在 PATH 里:
uvx --version
提示找不到命令就先解决。后面很多报错其实都是这一条换了个样子冒出来。见 spawn uvx ENOENT。
下载项目的 .rbz。SketchUp 里打开窗口 → 扩展程序管理器,点安装扩展程序,选那个文件。然后重启 SketchUp。
有的项目还在插件菜单下放了设置面板,要先打开 Ruby 执行权限才会接受命令。插件装上了毫无反应,先看这里。
{
"mcpServers": {
"sketchup": {
"command": "uvx",
"args": ["sketchup-mcp"]
}
}
}
必须是合法 JSON。多一个逗号,或者从网页复制带了中文引号,客户端会一声不吭地失败,列表里什么都不显示。这是最常见的错。
完全退出再打开 AI 客户端。大多数客户端运行中不重读配置。SketchUp 的工具应该出现在工具列表里。
先问点小的:「这个模型里有几个群组」。答得上来再去干创建几何体的活。
插件和服务通过本地端口通信。哪个端口看项目:9876 和 8080 都有人用。被别的东西占着的话,插件正常加载、服务正常启动,然后什么都不工作。见端口那节。
梓人AI 把路线一整套替你做了,按软件逐个做。没有包管理器要装、没有 JSON 要改、没有 AI 客户端要注册,因为客户端就是这个软件。
不怕命令行、而且已经在付某个 AI 客户端的钱,走开源那条不额外花钱,核心的活它也干得了。注意那句「已经在付」:服务端免费,建模本身不免费,而这在国内往往最难凑齐。
软件这条值得花钱,如果:你不想拿一个晚上去调 PATH;不想再凑一个境外 AI 订阅;或者想每次都有人替你把连接检查一遍,而不是干到一半发现插件在某次更新后悄悄不加载了。