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(Model Context Protocol)サーバーをアプリケーション内に直接組み込みます。これにより Claude などの AI アシスタントが HTTP 経由で Sweet Home 3D を操作できるようになり、壁の作成、家具の配置、写真のレンダリングなどを、外部プロキシや別のサーバープロセスなしで行えます。

sweethome3d-mcp-server の使い方

Releases から最新の .sh3p ファイルをダウンロードし、Sweet Home 3D のプラグインフォルダー(OS ごとのパスは README を参照)にコピーしてから、Sweet Home 3D を再起動します。MCP サーバーはポート 9877 で自動的に起動します。Claude Desktop または Claude Code に HTTP エンドポイント http://localhost:9877/mcp を設定してください。プラグインには Tools → MCP Server に自動設定ボタンも用意されています。

sweethome3d-mcp-server の主な機能

  • 12 カテゴリ(シーン、壁、家具、部屋など)にわたる 42 個のコマンド
  • Sweet Home 3D 内で完結して動作し、外部プロキシは不要
  • ポート 9877 で自動起動し、設定ダイアログも用意
  • インメモリのスナップショット(チェックポイント)による元に戻す履歴をサポート
  • コマンドの一括実行と、新しいコマンドハンドラーの自動登録
  • すべてのオブジェクトに安定した UUID を付与し、座標系はセンチメートル単位

sweethome3d-mcp-server のユースケース

  • AI 支援による住宅設計――言語モデルに間取り図を作成・修正させる
  • テキストの説明から 3D シーンを自動生成する
  • 間取り図を SVG、PNG、Wavefront OBJ としてエクスポートし、さらに加工する
  • 1 回のリクエストで家具の配置や壁の作成を一括で行う
  • 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

macOS で MCP サーバーが起動しないのはなぜですか?

Mac App Store 版の Sweet Home 3D はサンドボックス化されており、ネットワークサーバーのエンタイトルメントがありません。代わりに sweethome3d.com のスタンドアロンインストーラーを使用してください。

4

プラグインを使うように Claude を設定するにはどうすればよいですか?

Claude Desktop の `claude_desktop_config.json` または Claude Code の `.mcp.json` に `"sweethome3d": {"type": "http", "url": "http://localhost:9877/mcp"}` を追加します。プラグインの Tools → MCP Server ダイアログから自動で書き込むこともできます。

5

ソースからビルドする際、プラグインは Sweet Home 3D の JAR をどこで探しますか?

ビルドスクリプトはまずローカルにインストールされた SH3D を確認し(最も高速で、オフラインでも動作します)、見つからなければ SourceForge から `SweetHome3D.jar` をダウンロードします。3 つの Java3D の JAR は `lib/` に同梱されています。

コメント

「その他」の他のコンテンツ