Sweet Home 3D 插件嵌入 MCP 服务器——让 Claude 通过 HTTP 控制 Sweet Home 3D
概览
一款Sweet Home 3D插件，直接在应用内嵌入MCP（模型上下文协议）服务器。让Claude和其他AI助手通过HTTP控制Sweet Home 3D——创建墙壁、摆放家具、渲染照片等——无需任何外部代理或独立服务器进程。 Sweet Home 3D 自带一个 JRE。确保是 Java 11+。非常老旧的 SH3D 版本（32位 Windows 安装程序，JRE 1.8）会因为 UnsupportedClassVersionError 而无声加载该插件。 从Releases下载最新的.sh3p文件。 把它复制到你的Sweet Home 3D插件文件夹里： （重）启Sweet Home 3D。MCP服务器会自动从9877端口启动。 你可以确认它正在运行：显示服务器状态。 Sweet Home 3D 的构建是沙箱的，发布时没有 com.apple.security.network.server 权限，因此不允许打开监听套接字。由于插件监听端口 9877，MCP 服务器无法在该构建下启动。
概述（AI 翻译）
一款Sweet Home 3D插件，直接在应用内嵌入MCP（模型上下文协议）服务器。让Claude和其他AI助手通过HTTP控制Sweet Home 3D——创建墙壁、摆放家具、渲染照片等——无需任何外部代理或独立服务器进程。
Claude Code 直接连接到该端点。Claude Desktop 需要一个小型本地桥接器（mcp-remote）
介于之间——参见克洛德构型。
截图
要求
| 需求 | 版本 |
|---|---|
| 甜蜜的家3D | 7.x（用7.5测试） |
| Java（与SH3D或系统捆绑） | 8及以上 |
| Node.js | 当前LTS——仅适用于Claude Desktop（运行mcp-remote桥接器） |
该插件可与 Sweet Home 3D 自带的 Java 8 运行时兼容。构建该插件需要 JDK 11+;运行它则不需要。
安装
步骤1. 从Releases下载sh3d-mcp-plugin-1.2.0.sh3p。
步骤2. 安装它。
macOS（最简单）：双击.sh3p文件。 Sweet Home 3D打开，安装
插件本身并用对话框确认。没有什么可以手动复制的。如果Finder没有复制
用 Sweet Home 3D 打开文件，右键点击并选择 用 Sweet Home 3D 打开→ Sweet Home 3D**。
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Sweet Home 3D MCP Plugin
A plugin for Sweet Home 3D that embeds an MCP (Model Context Protocol) server directly inside the application. Lets Claude and other AI assistants control Sweet Home 3D over HTTP — create walls, place furniture, render photos, and more — without any external proxy or separate server process.
Claude Desktop / Claude Code
│ HTTP (JSON-RPC 2.0)
▼
┌─────────────────────────────────────┐
│ Sweet Home 3D + MCP Plugin │
│ Built-in HTTP server on port 9877 │
│ http://127.0.0.1:9877/mcp │
└─────────────────────────────────────┘
Claude Code connects to this endpoint directly. Claude Desktop needs a small local bridge (mcp-remote) in
between — see Claude Configuration.
Screenshots
Requirements
| Requirement | Version |
|---|---|
| Sweet Home 3D | 7.x (tested with 7.5) |
| Java (bundled with SH3D or system) | 8 or newer |
| Node.js | current LTS — only for Claude Desktop (runs the mcp-remote bridge) |
The plugin works with Sweet Home 3D’s bundled Java 8 runtime. Building the plugin requires JDK 11+; running it does not.
Installation
Step 1. Download sh3d-mcp-plugin-1.2.0.sh3p from Releases.
Step 2. Install it.
macOS (easiest): double-click the .sh3p file. Sweet Home 3D opens, installs the
plugin itself and confirms with a dialog. Nothing to copy by hand. If Finder does not
open the file with Sweet Home 3D, right-click it and choose Open With → Sweet Home 3D.
Double-clicking works the same way on Windows and Linux wherever the .sh3p extension
is associated with Sweet Home 3D.
Any platform (manual): copy the file into the plugins folder, creating the folder if it does not exist:
| OS | Plugins folder |
|---|---|
| Windows | %APPDATA%\eTeks\Sweet Home 3D\plugins\ |
| macOS | ~/Library/Application Support/eTeks/Sweet Home 3D/plugins/ |
| Linux | ~/.eteks/sweethome3d/plugins/ |
Step 3. (Re)start Sweet Home 3D. The MCP server starts automatically on port 9877.
You can verify it is running: Tools → MCP Server… shows the server status.
Troubleshooting
macOS: the MCP server won’t start (cannot open port)
The Mac App Store build of Sweet Home 3D is sandboxed and ships without the
com.apple.security.network.server entitlement, so it is not allowed to open a
listening socket. Because the plugin listens on port 9877, the MCP server
cannot start under that build.
安装
npx -y [email protected] http://127.0.0.1:9877/mcp配置
{
"mcpServers": {
"sweethome3d": {
"type": "http",
"url": "http://127.0.0.1:9877/mcp",
"headersHelper": "printf '{\"Authorization\":\"Bearer %s\"}' \"$(cat \"$HOME/Library/Application Support/eTeks/Sweet Home 3D/plugins/sh3d-mcp.token\")\""
}
}
}