MCP.so
登录

Sweethome3d MCP Server

@grimashevich

基本信息

分类

其他

许可证

GPL-2.0

作者

grimashevich

关于 Sweethome3d MCP Server

内嵌 MCP 服务器的 Sweet Home 3D 插件——让 Claude 通过 HTTP 控制 Sweet Home 3D

Sweethome3d MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "sweethome3d": {
      "type": "http",
      "url": "http://localhost:9877/mcp"
    }
  }
}

Sweethome3d MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,直接连接服务器端点实时获取工具列表。

概览

什么是 sweethome3d-mcp-server?

这是一个 Sweet Home 3D 插件,它将 MCP(模型上下文协议)服务器直接嵌入应用内部,让 Claude 及其他 AI 助手可以通过 HTTP 控制 Sweet Home 3D——创建墙体、摆放家具、渲染照片等——无需任何外部代理或独立的服务器进程。

如何使用 sweethome3d-mcp-server?

从 Releases 下载最新的 .sh3p 文件,将其复制到 Sweet Home 3D 的插件文件夹(各操作系统的路径见 README),然后重启 Sweet Home 3D。MCP 服务器会自动在 9877 端口启动。在 Claude Desktop 或 Claude Code 中配置 HTTP 端点 http://localhost:9877/mcp 即可。插件还在 Tools → MCP Server 下提供了一键自动配置按钮。

sweethome3d-mcp-server 的主要功能

  • 42 条命令,分为 12 个类别(场景、墙体、家具、房间等)
  • 完全在 Sweet Home 3D 内部运行,无需外部代理
  • 在 9877 端口自动启动,并提供设置对话框
  • 通过内存快照(检查点)支持撤销时间线
  • 支持批量执行命令,并自动注册新的命令处理器
  • 所有对象都有稳定的 UUID;坐标系以厘米为单位

sweethome3d-mcp-server 的使用场景

  • AI 辅助家居设计——让语言模型创建和修改平面图
  • 根据文字描述自动生成 3D 场景
  • 将平面图导出为 SVG、PNG 或 Wavefront OBJ,以便进一步处理
  • 在一次请求中批量摆放家具或创建墙体
  • 与 Claude Desktop 或 Claude Code 集成,进行迭代式设计

常见问题

1

系统要求是什么?

需要 Sweet Home 3D 6.0 或更高版本,以及 Java 11 或更高版本。非常旧的 SH3D 版本所捆绑的 JRE(例如带 JRE 1.8 的 32 位 Windows 版)会静默失败。

2

服务器运行在哪个端口?

HTTP(JSON-RPC 2.0)服务器监听 `127.0.0.1:9877`,端点为 `/mcp`。

3

为什么 MCP 服务器在 macOS 上无法启动?

Mac App Store 版的 Sweet Home 3D 运行在沙盒中,缺少网络服务器权限。请改用 sweethome3d.com 提供的独立安装程序。

4

如何配置 Claude 使用该插件?

将 `"sweethome3d": {"type": "http", "url": "http://localhost:9877/mcp"}` 添加到 Claude Desktop 的 `claude_desktop_config.json` 或 Claude Code 的 `.mcp.json` 中。插件也可以通过 Tools → MCP Server 对话框自动写入该配置。

5

从源码构建时,插件会在哪里查找 Sweet Home 3D 的 JAR 文件?

构建脚本会先检查本地安装的 SH3D(速度最快,可离线使用),找不到时再从 SourceForge 下载 `SweetHome3D.jar`。三个 Java3D JAR 文件已包含在 `lib/` 中。

评论

其他 分类下的更多 MCP 服务器