GS

grimashevich/sweethome3d-mcp-server

Browser automation

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

73 stars 20 forks 品質 74 トレンド 35GPL-2.0

MCP サーバーを埋め込む Sweet Home 3D プラグイン — Claude コントロール Sweet Home 3D を HTTP 経由で制御できます

概要

アプリケーション内で直接MCP(Model Context Protocol)サーバーを埋め込む Sweet Home 3D用のプラグインです。 Claude と他の AI アシスタントが HTTP 上で Sweet Home 3D を制御 — 壁の作成、家具の配置、写真のレンダリングなど — 外部プロキシや別のサーバープロセスなし。 JREをバンドルしたスウィートホーム3D船。 Java 11+ であることを確認してください。 非常に古いSH3Dビルド(JRE 1.8で32ビットWindowsインストーラ)は、UnsupportedClassVersionErrorのためにプラグインをロードするのをサイレントに失敗します。 リリースから最新の .sh3p ファイルをダウンロードします。 Sweet Home 3Dプラグインフォルダーにコピーします。 (リスタート)スウィートホーム3D. MCP サーバーは、ポート 9877 で自動的に起動します。 実行中のことを確認することができます: サーバーの状態を示します。 Sweet Home 3D のビルドは、com.apple.security.network.server のエンタイトルを使わずにサンドボックス化され、リスニングソケットを開くことはできません。 プラグインはポート 9877 で listen するので、MCP サーバーはビルド中に起動できません.

概要(AI 翻訳)

アプリケーション内で直接MCP(Model Context Protocol)サーバーを埋め込む Sweet Home 3D用のプラグインです。 Claude と他の AI アシスタントが HTTP 上で Sweet Home 3D を制御 — 壁の作成、家具の配置、写真のレンダリングなど — 外部プロキシや別のサーバープロセスなし。

クロードコードは、このエンドポイントに直接接続します。 クロードデスクトップは、小さなローカルブリッジ(mcp-remote)を必要とします 間で — Claude の設定を参照してください。

スクリーンショット

要件

| 条件 | バージョン | お問い合わせ | スウィートホーム3D | 7.x(7.5テスト済み) | | Java(SH3Dまたはシステムで配布) | 8 または newer | | Node.js | 現在のLTS — クロード・デスクトップ専用([mcp-remote]ブリッジ) |

プラグインは、Sweet Home 3DのバンドルされたJava 8ランタイムで動作します。 プラグインを作成するには、JDK 11+ が必要です。実行しないでください。

インストール

ステップ1. リリースから[sh3d-mcp-plugin-1.2.0.sh3pをダウンロードします。

手順 2. インストールします。

macOS(最も簡単です):[.sh3p]ファイルをダブルクリックします。 スウィートホーム3Dが開き、インストールします プラグイン自体とダイアログで確認します。 手でコピーするのはなし。 Finderがない場合 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\")\"" } } }