📦

SketchUp

Ruby plugin for SketchUp 3D modeling with geometry creation, entity transformation, material assignment, and model introspection via TCP bridge.

0 installs

Trust: 34 — Low

Files

Ask AI about SketchUp

I know everything about SketchUp. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

SU MCP Server

SketchUp MCP (Model Context Protocol) 服务器插件，使 AI 客户端（如 Claude）能通过标准化协议与 SketchUp 交互，实现 AI 辅助 3D 建模。

架构

MCP客户端 (Claude) <--stdio--> stdio_bridge.py <--TCP--> SketchUp TCP Server

SketchUp 内部: 非阻塞 TCP 服务器 (端口 9876)，使用 UI.start_timer 轮询
stdio_bridge.py: 跨平台 Python 脚本，桥接 stdio 和 TCP（无外部依赖）
SketchUp 插件: 全部纯 Ruby 实现，无外部 gem 依赖

安装

将 su_mcp.rb 和 su_mcp/ 文件夹复制到 SketchUp 的 Plugins 目录:
- Windows: %APPDATA%\SketchUp\SketchUp 2024\SketchUp\Plugins\
- macOS: ~/Library/Application Support/SketchUp 2024/SketchUp/Plugins/
重启 SketchUp，在 Extension Manager 中确认 "SU MCP Server" 已启用

使用

启动服务器

菜单: Extensions > SU MCP Server > Start Server
或在 Ruby Console 中: OnePitaph::SuMcp::PluginManager.start_server

配置 Claude Desktop

编辑 Claude Desktop 配置文件：

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows (需先将 stdio_bridge.py 复制到纯英文路径):

{
  "mcpServers": {
    "sketchup": {
      "command": "python",
      "args": ["C:\\su_mcp_bridge\\stdio_bridge.py"],
      "env": { "SU_MCP_PORT": "9876" }
    }
  }
}

macOS:

{
  "mcpServers": {
    "sketchup": {
      "command": "python3",
      "args": ["/path/to/bridge/stdio_bridge.py"],
      "env": { "SU_MCP_PORT": "9876" }
    }
  }
}

依赖: Python 3（macOS 内置；Windows 若无请从 python.org 安装并勾选 "Add Python to PATH"）

配置保存后，完全重启 Claude Desktop 生效。

可用工具

工具名	说明	只读
`get_model_info`	获取模型概要信息	✅
`get_selection`	获取当前选中实体	✅
`create_geometry`	创建几何体 (面/边/组/盒子)	❌
`transform_entities`	变换实体 (移动/旋转/缩放)	❌
`set_material`	设置材质颜色	❌
`get_entity_info`	获取实体详细信息	✅
`delete_entities`	删除实体	❌
`execute_ruby`	执行任意 Ruby 代码	❌

自定义配置

OnePitaph::SuMcp.configure do |c|
  c.port = 8888
  c.log_level = :debug
  c.max_clients = 10
end

文件结构

su_mcp/
├── su_mcp.rb              # 扩展加载器
├── su_mcp/                # 支撑文件夹
│   ├── main.rb            # 插件入口
│   ├── version.rb         # 版本
│   ├── config.rb          # 配置
│   ├── server/            # TCP/JSON-RPC 传输层
│   ├── mcp/               # MCP 协议抽象
│   ├── tools/             # 工具实现
│   └── utils/             # 工具函数
├── bridge/
│   ├── stdio_bridge.py    # Stdio 桥接脚本 (Python, 推荐跨平台)
│   └── stdio_bridge.rb    # Stdio 桥接脚本 (Ruby, 备用)
└── README.md