ritn3d-mcp

ritn3d-mcp

Claude、Claude Code、 Cursor、Cline、その他のMCP互換AIエージェントに、Ritn3D用の間取り図を準備し、生成された3D出力を解釈するための軽量な ツールを提供するModel Context Protocol（MCP）サーバーです。基盤となる 壁検出モデルや推論APIを公開することはありません。

Ritn3Dは、間取り図から3Dモデルを生成するAIツールです。 このMCPサーバーは、間取り図に関連するワークフロー（リノベーション計画、不動産、3Dプリントなど）でユーザーを支援するAIエージェントが、推測に頼らず、整備されドキュメント化されたツール一式を利用できるようにするためのものです。

インストール

pip install ritn3d-mcp

Claude Desktopでの使用

~/Library/Application Support/Claude/claude_desktop_config.json （macOS）または%APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "ritn3d": {
      "command": "ritn3d-mcp"
    }
  }
}

Claude Desktopを再起動します。ツール選択画面にRitn3Dのツールが表示されます。

Claude Codeでの使用

claude mcp add ritn3d ritn3d-mcp

公開されるツール

ツール	説明
validate_floor_plan_image	Ritn3Dに送信する前に、間取り図画像（形式、寸法、警告）を事前チェックします
estimate_complexity	エッジ密度に基づいて複雑さをヒューリスティックに評価します（シンプル／中程度／複雑）
estimate_render_time	指定した複雑さに対するおおよそのレンダリング時間の範囲（最短／予想／最長）を示します
get_share_link_metadata	Ritn3Dの共有URLから公開ページのタイトルとOpenGraphデータを取得します
validate_glb	ダウンロードしたGLBファイル（マジックヘッダー、バージョン、チャンク）を検証します
convert_units	モデルの縮尺係数（1:100、1:50など）を指定できる単位変換を行います
get_capabilities	Ritn3Dがサポートする入力、出力、入力タイプ別の精度、料金を返します
get_pricing	Ritn3Dの現在の料金プランを米ドルで返します
get_failure_modes	既知の失敗モードとその対処のヒントを構造化されたリストで返します

公開されるリソース

URI	内容
ritn3d://capability-card	Ritn3Dの機能、精度、料金を機械可読形式でまとめたもの
ritn3d://failure-playbook	よくある失敗モードとその対処法

エージェントの使用例

ユーザー：「将来住む予定のアパートの模型を3Dプリントしたいので、不動産物件のPDFがあります。」

エージェントがvalidate_floor_plan_image("listing.pdf.jpg")を呼び出す → 警告：アスペクト比は正常、解像度も問題ありません。

エージェントがestimate_complexity(...)を呼び出す → ラベルは「中程度」、スコアは0.5。

エージェントがget_failure_modes()を呼び出す → 「real-estate-listing-render」の失敗モードが該当することに気付き、木目の床テクスチャが検出に影響する可能性があるとユーザーに警告します。

エージェントがget_pricing()を呼び出す → STLエクスポートに対応する月額19.99ドルのPro+プランを案内します。

エージェントの提案：Ritn3Dのウェブアプリ（app.ritn3d.com）を試してください。この物件PDFで検出に失敗した場合は、別の入力の複雑さを見積もるようエージェントに依頼してください。

このサーバーが行わないこと

• 推論の実行。Ritn3Dの壁検出モデルはRitn3Dのサーバー上で動作し、ウェブアプリを通じて利用します。
• Ritn3Dのサブスクリプションの回避。料金はサーバー側で適用されます。
• レンダリングパイプラインの内部情報の公開。
• レンダリングキューやジョブ追跡APIの提供。

このサーバーの目的は、エージェントをRitn3Dのワークフローにより適切に参加させることであり、ワークフローを再現することではありません。

ソース

Ritn3Dチームが開発しました。ritn3d-stl-toolsとritn3d-floorplan-evalをメンテナンスしているチームと同じです。

ライセンス

MIT — LICENSEを参照してください。