grimashevich/sweethome3d-mcp-server

Browser automation

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

73 stars 20 forks Качество 74 Тренд 35GPL-2.0

Repository Install

Плагин Sweet Home 3D, который встраивает MCP-сервер, позволяет Клоду управлять Sweet Home 3D по HTTP

Обзор

Плагин для Sweet Home 3D, который встраивает сервер MCP (Model Context Protocol) непосредственно в приложение. Позволяет Клоду и другим помощникам ИИ управлять Sweet Home 3D по HTTP — создавать стены, размещать мебель, делать фотографии и многое другое — без какого-либо внешнего прокси или отдельного серверного процесса. Корабли Sweet Home 3D с комплектом JRE. Убедитесь, что это Java 11+. Очень старые сборки SH3D (32-разрядный установщик Windows с JRE 1.8) молча не смогут загрузить плагин из-за неподдерживаемой ошибки ClassVersion. Скачайте последний файл .sh3p из Releases. Скопируйте это в папку 3D плагинов Sweet Home: Скачать Sweet Home 3D Сервер MCP автоматически запускается на порту 9877. Вы можете проверить его работоспособность: показывает состояние сервера. Сборка Sweet Home 3D упакована в песочницу и поставляется без права com.apple.security.network.server, поэтому не разрешается открывать розетку для прослушивания. Поскольку плагин прослушивает порт 9877, сервер MCP не может запуститься под этой сборкой.

Обзор (машинный перевод)

Код Клода подключается непосредственно к этой конечной точке. Claude Desktop нужен небольшой локальный мостик См.: Claude Configuration.

Скриншоты

Требования

Плагин работает с Sweet Home 3D в комплекте с Java 8. Для создания плагина требуется JDK 11+, а для его запуска нет.

##Установка

Шаг 1.** Скачать sh3d-mcp-plugin-1.2.0.sh3p из выпусков.

Шаг 2.Установите его.

*macOS (проще всего): дважды щелкните файл .sh3p. Sweet Home 3D открывается Сам плагин и подтверждается диалогом. Нечего копировать вручную. Если поисковик не Откройте файл с помощью Sweet Home 3D, щелкните правой кнопкой мыши и выберите Open With → Sweet Home 3D.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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.

Открыть полный README на GitHub

Установка

npx -y [email protected] http://127.0.0.1:9877/mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "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\")\""
    }
  }
}