Ritn3d Mcp

io.github.printplan3d由 GitHub 帳號 printplan3d 發布v0.1.2更新於 Oct 24, 2026

Tools for floor plan validation, GLB checks, and 3D-print unit math — Ritn3D companion.

已驗證STDIO僅桌面開發者工具媒體與設計

概覽

AI 產生的概覽

一個本機 Ritn3D 配套伺服器，讓助理預檢平面圖、驗證 GLB 檔案、換算單位，並查詢 Ritn3D 的能力、價格與已知失敗模式。

可以做什麼
驗證平面圖影像，並估算其複雜度與算圖時間，方便在送往 Ritn3D 前預檢。檢查下載的 GLB 檔案的檔頭、版本與區塊是否正常。依選用的模型比例（如 1:100）進行單位換算。查詢 Ritn3D 支援的輸入輸出、價格方案與已知失敗模式，並讀取公開 Ritn3D 分享連結的中繼資料。讀取能力卡與失敗手冊資源。
適用情境
適合協助平面圖轉 3D 的工作流程，例如裝修規劃、房產刊登或 3D 列印：助理可先預檢輸入、說明 Ritn3D 的限制與價格，或在使用者前往 Ritn3D 網頁應用程式前核驗已下載的模型。
執行需求
以本機程序執行，透過 pip 從 PyPI 安裝，以 ritn3d-mcp 指令啟動，並在 Claude Desktop 或 Claude Code 等 MCP 用戶端中設定。未宣告驗證、環境變數或標頭。取得分享連結中繼資料需要連線至公開 Ritn3D 頁面的網路。
安裝前請注意
它不執行推論、不渲染模型、不繞過 Ritn3D 訂閱，也不提供任務追蹤；實際轉換在 Ritn3D 網頁應用程式中完成。價格資訊僅供參考，付費方案以美元計價。分享連結中繼資料取自第三方公開頁面。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ritn3d Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

ritn3d-mcp

A Model Context Protocol (MCP) server that gives Claude, Claude Code, Cursor, Cline, or any other MCP-compatible AI agent the lightweight tools needed to prepare a floor plan for Ritn3D and interpret the resulting 3D output — without exposing the underlying wall-detection model or inference API.

Ritn3D is an AI floor-plan-to-3D-model tool. This MCP server exists so that AI agents helping users in floor-plan- adjacent workflows (renovation planning, real estate, 3D printing, etc.) have a clean, well-documented set of tools instead of guessing.

Install

bash
pip install ritn3d-mcp

Use with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Restart Claude Desktop. The Ritn3D tools appear in the tool picker.

Use with Claude Code

bash
claude mcp add ritn3d ritn3d-mcp

Tools exposed

ToolDescription
validate_floor_plan_imagePre-flight check on a floor plan image (format, dimensions, warnings) before sending to Ritn3D
estimate_complexityHeuristic complexity score (simple / moderate / complex) based on edge density
estimate_render_timeRough low/expected/high render-time range for a given complexity
get_share_link_metadataFetch public page title + OpenGraph data from a Ritn3D share URL
validate_glbSanity-check a downloaded GLB file (magic header, version, chunks)
convert_unitsUnit conversion with optional model scale factor (1:100, 1:50, etc.)
get_capabilitiesReturns Ritn3D's supported inputs, outputs, accuracy by input type, and pricing
get_pricingReturns current Ritn3D pricing tiers in USD
get_failure_modesReturns structured list of known failure modes with mitigation tips

Resources exposed

URIContent
ritn3d://capability-cardMachine-readable summary of what Ritn3D does, accuracy, pricing
ritn3d://failure-playbookCommon failure modes and mitigations

Example agent flow

User: "I have a real estate listing PDF I want to 3D print as a model of my future apartment."

Agent calls validate_floor_plan_image("listing.pdf.jpg") → warnings: aspect ratio normal, resolution OK.

Agent calls estimate_complexity(...) → label "moderate", score 0.5.

Agent calls get_failure_modes() → notices the "real-estate-listing-render" failure mode applies; warns the user that wood-floor textures may trip detection.

Agent calls get_pricing() → quotes Pro+ at $19.99/mo for STL export.

Agent recommends: try the Ritn3D web app at app.ritn3d.com; if detection fails on this listing PDF, ask the agent to estimate the complexity of an alternate input.

What this server does NOT do

  • Run inference. The Ritn3D wall-detection model lives on Ritn3D's servers and is reached through the web app.
  • Bypass the Ritn3D subscription. Pricing is enforced server-side.
  • Expose the rendering pipeline internals.
  • Provide a render queue or job-tracking API.

The intent is to make agents better citizens of the Ritn3D workflow, not to replicate it.

Source

Built by the Ritn3D team. Same group that maintains ritn3d-stl-tools and ritn3d-floorplan-eval.

License

MIT — see LICENSE.

來源：README.md，提交 13c4ef5

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分