ritn3d-mcp

ritn3d-mcp

一个模型上下文协议（MCP）服务，为 Claude、Claude Code、 Cursor、Cline 或任何其他兼容 MCP 的 AI Agent 提供轻量级 工具，用于为 Ritn3D 准备平面图并解读生成的 3D 输出， 而无需暴露底层的墙体检测模型或推理 API。

Ritn3D 是一款可将平面图转换为 3D 模型的 AI 工具。 此 MCP 服务旨在为协助用户处理平面图相关工作流（装修规划、房地产、3D 打印等）的 AI Agent 提供一组清晰且文档齐全的工具，而不是让它们自行猜测。

安装

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 当前以 USD 计价的价格方案
get_failure_modes	返回已知失败模式的结构化列表及缓解建议

提供的资源

URI	内容
ritn3d://capability-card	Ritn3D 功能、准确度和定价的机器可读摘要
ritn3d://failure-playbook	常见失败模式及缓解方法

Agent 工作流示例

用户：“我有一份房地产房源 PDF，想把它 3D 打印成未来公寓的模型。”

Agent 调用 validate_floor_plan_image("listing.pdf.jpg") → 警告：宽高比正常，分辨率合适。

Agent 调用 estimate_complexity(...) → 标签为“中等”，评分为 0.5。

Agent 调用 get_failure_modes() → 发现适用“房地产房源渲染”失败模式；提醒用户木地板纹理可能会影响检测。

Agent 调用 get_pricing() → 报价为 Pro+ 套餐，STL 导出每月 $19.99。

Agent 建议：试用 Ritn3D 网页应用 app.ritn3d.com；如果无法检测这份房源 PDF，可让 Agent 评估其他输入的复杂度。

此服务不会做什么

• 执行推理。Ritn3D 墙体检测模型运行在 Ritn3D 的服务器上，需通过网页应用访问。
• 绕过 Ritn3D 订阅。定价由服务器端强制执行。
• 暴露渲染流程的内部细节。
• 提供渲染队列或作业跟踪 API。

我们的目的是让 Agent 更好地融入 Ritn3D 工作流，而不是复制它。

来源

由 Ritn3D 团队构建。该团队还维护 ritn3d-stl-tools 和 ritn3d-floorplan-eval。

许可证

MIT — 参见 LICENSE。