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 分