create_family_instances
Generate and place Revit family instances with various placement options, including levels, views, and curves. Supports batch creation, unit conversion, rotation, and precise positioning using JSON-RPC 2.0.
Instructions
在Revit中创建族实例,支持多种放置方式,遵循JSON-RPC 2.0规范。 mcp_tool使用时params不要有任何注释信息
特性:
- 支持批量创建多个族实例
- 自动处理单位转换(毫米转英尺)
- 支持多种放置类型:
- 基于标高放置
- 基于视图放置
- 基于工作平面放置
- 基于宿主放置
- 基于曲线放置
- 支持旋转和偏移
- 自动匹配族类型和类别
- 完善的错误处理机制
参数: ctx (Context): FastMCP上下文对象 method (str): JSON-RPC方法名,默认为"CreateFamilyInstances" params (List[Dict]): 族实例参数列表,每个字典包含: - categoryName (str): 支持按类别BuiltInCategory或者Category.Name查找(如"OST_Walls","OST_Doors", "墙", "门", "结构框架"等) - name (str): 族类型名称 - startX (float): 起点X坐标(毫米) - startY (float): 起点Y坐标(毫米) - startZ (float): 起点Z坐标(毫米) - familyName (str, optional): 族名称(可选,用于更精确匹配) - endX (float, optional): 终点X坐标(毫米,默认等于startX) - endY (float, optional): 终点Y坐标(毫米,默认等于startY) - endZ (float, optional): 终点Z坐标(毫米,默认等于startZ) - hostId (str, optional): 宿主元素ID(可选) - viewName (str, optional): 视图名称(可选) - rotationAngle (float, optional): 旋转角度(度,默认0) - offset (float, optional): 偏移距离(毫米,默认0)
返回: dict: JSON-RPC 2.0格式的响应,结构为: 成功时: { "jsonrpc": "2.0", "result": [ { "elementId": "元素ID", "name": "名称", "familyName": "族名称" }, ... ], "id": request_id } 失败时: { "jsonrpc": "2.0", "error": { "code": int, "message": str, "data": any }, "id": request_id }
示例: # 创建多个族实例 response = create_family_instances(ctx, params=[ # 基于标高的门 { "categoryName": "窗", "name": "0406 x 0610mm", "startX": 1000, "startY": 2000, "startZ": 0, "hostId": 225535, "level": "标高 1", }, # 基于视图的家具 { "categoryName": "OST_Furniture", "name": "办公桌", "startX": 3000, "startY": 4000, "startZ": 0, "viewName": "标高 1", "rotationAngle": 90 }, # 基于曲线的梁 { "categoryName": "OST_StructuralFraming", "name": "H型钢梁", "startX": 0, "startY": 0, "startZ": 3000, "endX": 5000, "endY": 0, "endZ": 3000 } ])
Input Schema
Name | Required | Description | Default |
---|---|---|---|
method | No | CreateFamilyInstances | |
params | No |
Input Schema (JSON Schema)
You must be authenticated.
Other Tools from Revit MCP Server
- active_view
- call_func
- create_cable_trays
- create_door_windows
- create_ducts
- create_family_instances
- create_floor_plan_views
- create_floors
- create_grids
- create_levels
- create_pipes
- create_rooms
- create_room_tags
- create_sheets
- create_walls
- delete_elements
- execute_commands
- find_elements
- get_commands
- get_locations
- get_selected_elements
- link_dwg_and_activate_view
- move_elements
- parameter_elements
- show_elements
- update_elements
Related Tools
- @ZedMoster/revit-mcp
- @ZedMoster/revit-mcp
- @ZedMoster/revit-mcp
- @ZedMoster/revit-mcp
- @ZedMoster/revit-mcp