grimashevich/sweethome3d-mcp-server

Browser automation

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

73 stars 20 forks 품질 74 트렌드 35GPL-2.0

Repository Install

Sweet Home 3D 플러그인은 MCP 서버를 포함 — Claude control Sweet Home 3D를 HTTP로 허용

개요

Sweet Home 3D를 위한 플러그인으로 MCP(모델 Context Protocol) 서버가 직접 애플리케이션에 삽입합니다. Claude 및 기타 AI 조수는 HTTP를 통해 달콤한 홈 3D를 제어합니다. - 벽, 장소 가구, 렌더링 사진 및 기타 - 외부 프록시 또는 별도의 서버 프로세스없이. 묶인 JRE로 달콤한 홈 3D 배. Java 11+를 확인합니다. 매우 오래된 SH3D는 UnsupportedClassVersionError로 인해 플러그인을로드하지 못합니다. 릴리스의 최신 .sh3p 파일을 다운로드합니다. 당신의 달콤한 홈 3D 플러그인 폴더에 복사: (Re)스타트 스위트 홈 3D. MCP 서버는 포트 9877에 자동으로 시작합니다. 서버 상태를 확인할 수 있습니다. 달콤한 홈 3D의 빌드는 com.apple.security.network.server 제목없이 샌드 박스 및 배입니다, 그래서 듣는 소켓을 열 수 없습니다. 플러그인은 포트 9877에 듣기 때문에 MCP 서버는 그 빌드에서 시작할 수 없습니다.

개요(AI 번역)

Sweet Home 3D를 위한 플러그인으로 MCP(모델 Context Protocol) 서버가 직접 애플리케이션에 삽입합니다. Claude 및 기타 AI 조수는 HTTP를 통해 달콤한 홈 3D를 제어합니다. - 벽, 장소 가구, 렌더링 사진 및 기타 - 외부 프록시 또는 별도의 서버 프로세스없이.

Claude Code는 이 엔드포인트에 직접 연결됩니다. Claude 데스크톱은 작은 지역 교량 (mcp-remote])을 필요로 합니다. 사이 - Claude 구성을 참조하십시오.

스크린샷

요구 사항

문의	버전
달콤한 홈 3D	7.x(7.5)
Java(SH3D 또는 시스템 포함)	8명 이상
Node.js	현재 LTS - Claude 데스크톱 전용([T1]] 브리지)

플러그인은 달콤한 홈 3D의 번들 Java 8 실행 시간을 사용합니다. 플러그인을 구축하려면 JDK 11 +; 실행하지 않습니다.

설치

** 단계 1.** 릴리스에서 sh3d-mcp-plugin-1.2.0.sh3p을 다운로드합니다.

** 단계 2. ** 설치.

macOS (easiest): 더블 클릭 .sh3p 파일. 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.

GitHub에서 전체 README 보기

설치

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