Local MCP for SketchUp

一个独立、免费、开源、可离线运行的本地 MCP 技术预览项目，用于让 Agent 在明确能力、目标和审核边界内与 SketchUp 协作。

当前版本：0.1.0-rc.4 发布准备中，尚未公开发布。

当前边界

当前核心服务暴露 41 个 MCP tools，覆盖能力发现、受控建模、现有模型编辑、 会话与队列诊断、审批和证据输出。工具注册表见 docs/tool-registry.md。

这仍是边界明确的技术预览候选：

• 不是完整 SketchUp Ruby API 封装；

• 不执行任意 Python 或任意 Ruby；

• 不承诺从照片全自动生成准确模型；

• 不代表所有 SketchUp 版本或所有 MCP 客户端已兼容；

• 离线检查、mock 测试和一次受控实机证据不等于正式发布验收。

首次发布的目标环境：

• SketchUp 2026 on macOS Apple Silicon；

• SketchUp 2026 on Windows x64。

首次发布不支持 Intel Mac。Windows 2026 实机验收尚待完成。

Related MCP server: mcp-taskflow

设计原则

• 安装完成后可在本地运行，不要求持续联网；

• 不包含遥测、运行时许可证校验或正版识别；

• 只接受结构化、可审阅的建模输入；

• 变更模型前执行能力、目标、路径和审批检查；

• 未知 MCP 客户端只生成手动配置片段，不猜测或覆盖其配置；

• Mock、离线和实机证据分层记录。

从源码检查

需要 Node.js 24 和 Ruby。克隆后运行：

npm ci
npm run core:check

core:check 是离线门禁，不会连接或修改正在运行的 SketchUp 模型。

生成一个明确标记为非正式发布的未签名 RBZ 预览包：

npm run plugin:package -- \
  --output-dir out/previews/local-review \
  --artifact-label local-review

正式 RBZ 必须再由 SketchUp Extension Signing Portal 注入官方签名；内部 manifest 中的签署字段不能替代该签名。未签名包可能被 SketchUp 的扩展加载 策略阻止。

MCP 客户端

首发安装协议为 Codex、Claude Desktop 和 Cursor 提供明确路径：

• Codex：安全合并 config.toml 中的 MCP server 表；

• Claude Desktop：采用其本地扩展安装流程，或提供手动配置；

• Cursor：安全合并已确认的 JSON MCP 配置；

• 其他客户端：只输出通用 stdio JSON 片段，由用户自行放入客户端配置。

自动配置必须先备份、拒绝符号链接和冲突项、只写允许的配置目录，并使用 随包 Node.js 的绝对路径。权限不足或客户端未知时，降级为校验下载并指导 用户通过 SketchUp Extension Manager 手动导入 RBZ。

安装协议草案见 docs/AGENT_INSTALL.md。正式固定版本 清单只会在制品签名、校验和平台验收完成后发布。

隐私和联网

常规运行不上传模型、队列内容或使用记录。下载安装时可以联网；安装完成后 不设置强制联网。详细的本地数据范围见 PRIVACY.md。

未来中国大陆官方安装渠道的登记表单属于独立服务，将在收集数据前单独说明 字段、用途、保存期限和联系方式。登记不用于验证 SketchUp 是否为正版。

开源与贡献

核心代码使用 Apache License 2.0。第三方组件见 THIRD_PARTY_NOTICES.md。贡献采用 DCO 1.1，请阅读 CONTRIBUTING.md。

安全问题请勿公开披露，按 SECURITY.md 联系 dtzhlq@126.com。

独立项目声明

本项目不是 Trimble Inc. 或 SketchUp 的官方产品，也未获其赞助、认可或合作 伙伴授权。“SketchUp”仅用于描述兼容对象。详见 TRADEMARKS.md。