English Français العربية

io.github.printplan3d/ritn3d-mcp

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.printplan3d/ritn3d-mcp؟

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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package ritn3d-mcp
Claude Code 
claude mcp add ritn3d-mcp -- python ritn3d-mcp==0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "ritn3d-mcp": {
            "command": "python",
            "args": [
                "ritn3d-mcp==0.1.2"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ritn3d-mcp
  2. Install
  3. Use with Claude Desktop
  4. Use with Claude Code
  5. Tools exposed
  6. Resources exposed
  7. Example agent flow
  8. What this server does NOT do
  9. Source
  10. License

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

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):

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

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

Use with Claude Code

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.

الأسئلة الشائعة

ما هو io.github.printplan3d/ritn3d-mcp؟

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

كيف أثبّت io.github.printplan3d/ritn3d-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add ritn3d-mcp -- python ritn3d-mcp==0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.printplan3d/ritn3d-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.printplan3d/ritn3d-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.printplan3d/ritn3d-mcp؟

ينشره printplan3d. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.